跳轉到主要內容
Seedance 2.0 可以基於可信參考素材生成影片——一張臉、一套服裝、一件商品、一段 聲音。為保證生成的一致性與合規,這些參考素材存放在模型推理時信任的私有素材庫中。 OrcaRouter 把該素材庫透過 /v1/asset 暴露出來。 本頁講素材庫怎麼運作、有什麼要求。具體端點、參數和線上偵錯,見 API Reference → Seedance Assets。

​
素材庫結構

  • 資產組（Asset Group）——容器。真人組裡一個組對應一個真人;虛擬組則是邏輯分組 （例如一個角色）。
  • 資產（Asset）——組內的單個檔案（圖片、影片或音訊）。只有狀態變為 Active 的資產才能用於生影片。
就緒的資產在影片請求中用 asset://<asset_id> 引用。

​
兩類資產組

兩類組的上傳與管理操作完全一致,區別只在怎麼建組。
虛擬（AIGC）真人（LivenessFace）
用途虛構 / AI 角色、道具、場景真人的肖像
建立方式直接呼叫建立介面由本人完成一次人臉核驗
原因無需保護身分涉及肖像權——在源頭採集本人授權
兩個庫都需要 Advanced Creation Rights,容量配額在兩者間共享。真人庫面向受邀帳號 開放。

​
素材檔案要求

素材以可公網存取的 URL 提供（不支援檔案上傳、不支援 base64）。限制:
類型格式約束
圖片jpeg、png、webp、bmp、tiff、gif、heic/heif寬高比(W/H) 0.4–2.5 · 單邊 300–6000 px · < 30 MB
影片mp4、mov480p/720p/1080p · 2–15 秒 · 寬高比 0.4–2.5 · 300–6000 px · 總像素 409,600–2,086,876 · 24–60 fps · ≤ 50 MB
音訊wav、mp32–15 秒 · ≤ 15 MB
肖像素材最佳實踐（利於人臉一致性）:
  • 全身參考:直圖,人物全身正面。
  • 臉部特寫:直圖,無表情,取景在肩部以上,臉部約佔畫面三分之二。
把同一個人的多張優質參考放進同一個組,能讓生成影片更忠實地還原其臉部與衣著。

​
資產生命週期（上傳是非同步的）

上傳資產會立即回傳 asset_id,檔案隨後在後台預處理。輪詢資產直到 Status 穩定:
  • Processing——仍在預處理,繼續輪詢。
  • Active——就緒,可用於生影片。
  • Failed——預處理被拒,查看 Error（如格式/尺寸、內容審核攔截,或真人組的 FaceMismatch）。
上傳時長不保證 SLA,影片素材比圖片更慢。資產回傳的簽名下載 URL 是臨時的（約 12 小時）。

​
真人核驗流程

真人組由本人完成一次核驗來建立。你的後端不接觸人臉資料,只編排流程:
1

發起會話

後端請求 OrcaRouter 發起核驗會話,拿到一個 H5 連結（託管的人臉核驗頁）和一個 session_id。
2

本人核驗

把 H5 連結交給終端使用者。他們在自己的裝置上開啟——無需登入 OrcaRouter——完成人臉 核驗。一次授權後,同一個人的新造型可以加進同一個組,無需重複核驗。
3

完成建組

核驗成功後,核驗頁會把終端使用者瀏覽器重新導向回 OrcaRouter 的回呼（自動處理）,新建的組 隨即登記好。若你傳了 return_url,使用者會回到你的頁面。
4

輪詢結果

後端輪詢會話,直到 status 為 success（帶新的 group_id）或 failed。之後上傳 素材、生成影片的方式與虛擬組完全一致。
人臉一致性。 向真人組上傳圖片時,會與核驗參考圖比對。非同一人（或一張圖裡有多張 臉）會被拒,資產變為 Failed / FaceMismatch。組的名稱和描述可在建組後透過更新組 介面設定。

​
配額

你的帳號有素材數量上限（預設 100,跨所有組合計）。超限的上傳會以 403 拒絕。

​
在影片生成中引用素材

資產 Active 後,在 Seedance 影片請求 的 metadata.content[] 裡用 asset://<asset_id> 引用,並在 prompt 中按類型 + 位置 （[Image 1]、[Video 1]、[Audio 1]）指代——不要直接寫 asset id: 
{
  "model": "byteplus/dreamina-seedance-2-0-260128",
  "prompt": "[Image 1] 中的女孩在櫃台整理物品。",
  "metadata": {
    "content": [
      { "type": "image_url", "role": "reference_image",
        "image_url": { "url": "asset://asset-20260318071009-xy98z" } }
    ]
  }
}

​
下一步

  • API Reference → Seedance Assets——每個端點、完整參數和線上偵錯台 （請求/回應範例在這裡）。
  • Seedance 影片——消費這些素材的影片生成端點。