Seed3D 2.0 API

ByteDance

1枚の画像から質感豊かな3Dモデル、キャラクターに強い

bytedance/seed3d-2.0/image-to-3d
  • 画像から3D

Seed3D 2.0 について

1枚の画像から質感豊かな3Dモデル、キャラクターに強い。

POST /jobs/createTask でモデル名に bytedance/seed3d-2.0/image-to-3d を指定すれば呼び出せます。$0.48から。

はじめに

Seed3D 2.0 は、ByteDance の Seed チームによる 3D アセットモデルで、2026 年 4 月に公開されました。1 枚の画像を読み取り、そこに写っている物体を素材付きの完全な 3D メッシュとして構築します。そのため、商品写真やキャラクターのレンダリングを、回転・ライティング・シーン配置が可能なモデルにできます。リクエストは 1 枚の画像(image_url)と、任意の密度切り替え(mesh_detail)を受け取ります。プロンプト、seed、スタイルのフィールドはありません。結果は、テクスチャを内包した 1 つのバイナリ glTF ファイル(.glb)です。

主な特長

1 枚の画像から形状と素材を

Seed3D 2.0 は形状と物理ベースの素材を同時に生成します。私たちの検証では、どのモデルも 4096×4096 のテクスチャ 2 枚(ベースカラーマップとメタルラフネスマップ)で返されました。そのため革は使い込まれたマットな質感に見え、真鍮のアイレットやヘルメットのバイザーにはハイライトが入ります。個別の法線マップはありません。表面のディテールはメッシュ自体に含まれています。

密で閉じたメッシュ

既定の medium では、2 つのテストモデルとも 1 つのメッシュと 1 つのマテリアルで、約 50 万三角形弱で返されました。low では同じブーツが 99,977 面でした。公式は各レベルを約 10 万、50 万、100 万面と説明しています。密なメッシュは靴紐、ステッチ、指などの小さな特徴をよく保ち、軽いメッシュはブラウザでの読み込みが速くなります。

私たちの計測

1024×1024 の革ブーツのスタジオ写真と、682×1024 のおもちゃの宇宙飛行士のレンダリングを送信しました。どちらも有効な GLB ファイルで返されました。サイズは 37.2 MB と 28.6 MB、三角形数は 499,998 と 499,992、処理時間は 356 秒と 340 秒でした。宇宙飛行士は顔、バイザー、胸のパネル、オレンジのトリムを全方向で保ちました。ブーツは真正面の平面的な画像として送ったため、背面の半分が前面の鏡像になりました。

リクエストパラメーター

パラメーター必須説明
image_urlはい出発点になる画像。
mesh_detailいいえメッシュ密度:low(約 10 万面)、medium(約 50 万面)、high(約 100 万面)。3 段階とも料金は同じで、段階が高いほど細部が残り、ファイルも大きくなります。 low · medium · high · デフォルト: medium

料金

料金は米ドル表示です。API は専用の米ドル残高を使用します。サイトのクレジットは API で使えず、API 残高との相互振替もできません。 タスクの受理時に、見積もりの上限額を API 残高から確保します。完了後は実際の使用量で精算し、確保額を超える請求はせず、差額を解放します。タスクが失敗した場合は確保額を解放します。

オプションUSD /回
標準$0.48

実行前に同じリクエスト本文を POST /jobs/quote に送ると、想定料金と上限額を米ドルで確認できます。見積もりではタスクの実行も課金も行いません。

活用シーン

EC と商品ビューア

パックショットを、商品ページや AR プレビュー用のインタラクティブなモデルにできます。商品は無地の背景で 4 分の 3 の角度から撮影またはレンダリングし、全体がフレームに収まるようにしてください。ディテールとダウンロードサイズのバランスには medium を使います。

キャラクター、玩具、コレクティブル

キャラクターのレンダリングやフィギュアの写真は、形状が単純で色が鮮やかなため、よく変換されます。テクスチャには顔、バッジ、ストライプなど描かれたディテールが乗ります。背面は推定されるため、キャラクターの大部分が見えるポーズを選んでください。

プロンプトガイドと上級者向けのコツ

画像を用意する

被写体は 1 つ、中央に配置し、周囲に余白を残して、フレームの端に触れないようにしてください。無地の明るい背景は物体をきれいに分離します。JPEG、PNG、WebP を 10 MB まで受け付け、画像の縦横比はおよそ 2:5 から 5:2 の範囲に収めてください。

角度を意図して選ぶ

モデルが見られるのは片側だけです。靴や車の真正面の画像では奥行きが分からず、見えない側が正面の鏡像で補われることがあります。正面と片側が見える 4 分の 3 の角度の方が、はるかに信頼できる結果になります。

使用場所に合わせて細かさを選ぶ

モバイルプレビューや小道具の多いシーンには low、ほとんどの Web ビューアには medium、近くで検査する場合や 3D プリントする場合には high を使ってください。

公開前に結果を確認する

ビューアで GLB を開き、全方向に回転させて、見せていない側を確認してください。背面がおかしい場合は、細かさを変えるよりも、別の角度の写真を試してください。

API クイックスタート

Seed3D 2.0 API を 3 ステップで呼び出す

  1. API キーを作成する. PopNow にログインし、API コンソールでキーを作成します。キーは sk-popnow- で始まり、API 呼び出しには専用の米ドル残高を使用します。
  2. リクエストを送る. POST /jobs/createTask に、model を bytedance/seed3d-2.0/image-to-3d、input をパラメーター表どおりにして送ります。レスポンスですぐにタスク ID が返ります。
  3. 結果を受け取る. タスク ID で GET /jobs/recordInfo をポーリングするか、callBackUrl を渡せば結果がそこへ送られます。タスクが成功したら出力リンクからダウンロードします。
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "bytedance/seed3d-2.0/image-to-3d",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "mesh_detail": "medium"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

プロンプトとリンクはご自身のものに置き換えてください。API タブにレスポンス、ポーリング、コールバックのリファレンスがあります。

Seed3D 2.0 API についての質問

Seed3D 2.0 API の料金はいくらですか?

Seed3D 2.0は$0.48/回です。API は専用の米ドル残高を使用します。サイトのクレジットは API で使えず、API 残高との相互振替もできません。 タスクの受理時に、見積もりの上限額を API 残高から確保します。完了後は実際の使用量で精算し、確保額を超える請求はせず、差額を解放します。タスクが失敗した場合は確保額を解放します。

API でのSeed3D 2.0のモデル名は?

POST /jobs/createTask の model フィールドに 画像から3Dは bytedance/seed3d-2.0/image-to-3d を指定します。

何が返ってきますか?

.glb ファイル(バイナリ glTF 2.0)が 1 つで、テクスチャは埋め込み済みです。検証ではベースカラーとメタリック/ラフネスの 2 枚、どちらも 4096×4096 の PNG でした。Blender、three.js、model-viewer、Unity、Unreal でそのまま読み込めます。

プロンプトは必要ですか?

いりません。必須の入力は画像だけです。mesh_detail は任意で、変わるのはメッシュの密度だけです。

どんな画像が向いていますか?

被写体は 1 つ、全体がフレームに収まり、背景は無地、角度は斜め 45 度。ごちゃごちゃした場面や見切れた物、真正面からの画像では、見えない部分をモデルが推測するしかありません。

Seed3D 2.0 API の制限は?

アップロードの上限:10 MB。この範囲を超えるリクエストは、課金される前に拒否されます。

コードを書かずにSeed3D 2.0を試せますか?

API キーなしで、API の米ドル残高を使って Playground から Seed3D 2.0 を実行できます。各実行は対応するコードとともに開発者の履歴に記録されます。

Seed3D 2.0 についてさらに