PopNowAPI
取得 API 金鑰

Seed3D 2.0 API

ByteDance 出品

一張圖產出貼圖豐富的 3D 模型，角色公仔尤其好

bytedance/seed3d-2.0/image-to-3d
  • 圖片轉 3D

關於 Seed3D 2.0

一張圖產出貼圖豐富的 3D 模型，角色公仔尤其好。

在 POST /jobs/createTask 把模型名稱填成 bytedance/seed3d-2.0/image-to-3d 就能呼叫，US$0.48 起。

簡介

Seed3D 2.0 是字節跳動 Seed 團隊的 3D 資產模型，2026 年 4 月發表。它讀入一張圖片，把其中的物件建構成帶材質的完整 3D 網格，因此一張產品照或角色渲染圖，就能變成可以旋轉、打光並放進場景中的模型。請求包含一張圖片（image_url）與一個選用的密度開關（mesh_detail），沒有提示詞、seed 或風格欄位。結果是一個二進位 glTF 檔案（.glb），貼圖已打包在檔案內。

主要特色

從一張圖得到幾何與材質

Seed3D 2.0 會同時生成形狀與基於物理的材質。在我們的測試中，每個模型都回傳兩張 4096×4096 貼圖：基礎色貼圖與金屬粗糙度貼圖，因此皮革看起來有磨損感、啞光，黃銅扣眼和頭盔面罩則會出現高光。沒有獨立的法線貼圖，表面細節就在網格本身。

緻密的封閉網格

在預設的 medium 檔位下，兩個測試模型都回傳了略低於 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 萬面）。三檔價格相同；檔位越高細節越多，檔案也越大。 low · medium · high · 預設值: medium

價格

價格以美元計。API 使用獨立的美元餘額。網站點數不能用於 API，也不能轉入 API 餘額；API 餘額同樣不能轉為網站點數。 任務受理時，從 API 餘額中保留報價的最高金額；完成後按實際用量結算，實際扣款不超過保留金額，並釋放剩餘金額。任務失敗則釋放保留金額。

選項USD /次
標準US$0.48

執行前，將相同請求內容傳送至 POST /jobs/quote，即可查看預估費用與最高費用，單位為美元。報價不會執行任務或扣款。

適用情境

電商與商品展示

一張商品照即可變成商品頁或 AR 預覽中的可互動模型。請在純色背景上以四分之三角度拍攝或渲染商品，確保整個物件都在畫面內，並使用 medium 檔位，在細節與下載大小之間取得平衡。

角色、玩具與收藏品

角色渲染圖與公仔照片轉換效果很好，因為它們的造型簡單、色彩鮮明。貼圖會承載繪製的細節，例如臉部、徽章與條紋；背面是推測出來的，所以請選擇能看見角色大部分的姿勢。

提示詞指南與進階技巧

準備圖片

畫面中只放一個主體，置中，四周留一些空白，且不要碰到畫面邊緣。淺色的純色背景能讓物件與背景分得清楚。可接受 JPEG、PNG 或 WebP，最大 10 MB，圖片的長寬比應介於約 2:5 到 5:2 之間。

刻意選擇角度

模型只看得到物件的一側。鞋子或汽車的正面平視圖無法得知物件的長度，被遮住的另一半可能會被補成正面的鏡像。能同時看到正面與一側的四分之三視角，結果可靠得多。

依使用場景選擇細節檔位

行動裝置預覽與道具很多的場景使用 low，多數網頁檢視器使用 medium，當模型需要近距離檢視或要做 3D 列印時使用 high。

上線前先檢查結果

在檢視器中打開 GLB，完整旋轉一圈，檢查你沒有展示的那一面。如果背面不對，請換一個拍攝角度的照片，而不是換另一個細節檔位。

API 快速上手

三步驟呼叫 Seed3D 2.0 API

  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：US$0.48/次。API 使用獨立的美元餘額。網站點數不能用於 API，也不能轉入 API 餘額；API 餘額同樣不能轉為網站點數。 任務受理時，從 API 餘額中保留報價的最高金額；完成後按實際用量結算，實際扣款不超過保留金額，並釋放剩餘金額。任務失敗則釋放保留金額。

Seed3D 2.0 在 API 裡的模型名稱是什麼？

在 POST /jobs/createTask 的 model 欄位填 圖片轉 3D用 bytedance/seed3d-2.0/image-to-3d。

Seed3D 2.0 API 有哪些限制？

單一檔案大小上限：10 MB。超出這些限制的請求會在扣款之前被拒絕。

不寫程式能試 Seed3D 2.0 嗎？

不需要 API 金鑰，即可在 Playground 用 API 美元餘額執行 Seed3D 2.0。每次執行都記入開發者紀錄，並附對應程式碼。

更多 Seed3D 2.0 相關內容