Seedance 數位人素材庫
使用原生 Action API 完成 Seedance 數位人素材的建立、驗證、上傳和引用。
Seedance 數位人素材庫用於管理 Seedance 2.0 和 Seedance 2.5 可引用的真人形象與虛擬形象素材。原生 API 保留 Action、Version 和對應的請求與回應結構，並透過 AGTCloud API Key 呼叫。
選擇素材類型
| 素材類型 | 建立方式 | 適用情境 | 主要限制 |
|---|---|---|---|
| 虛擬形象（AIGC） | 直接建立素材容器後上傳 | 虛擬主播、角色和產品素材 | 上傳網址必須可由伺服器存取 |
| 真人形象（LivenessFace） | 先完成人臉活體驗證 | 真人數位人和本人形象 | 素材必須與已驗證人臉一致 |
虛擬形象串接流程
建立素材容器
呼叫 CreateAssetGroup 建立 AIGC 素材群組，並儲存回傳的素材群組 ID。
上傳素材
將可公開存取的圖片、影片或音訊上傳至素材群組。上傳成功只表示請求已受理，素材通常會先進入處理中狀態。
等待素材可用
輪詢素材查詢 API，直到狀態變為 Active。進入 Failed 後請讀取錯誤資訊，不要繼續使用該素材。
在影片任務中引用
使用 asset://素材ID 或 asset://素材群組ID 作為 Seedance 原生建立請求中的素材 URL。引用的素材必須屬於目前帳戶並處於可用狀態。
真人形象串接流程
真人形象需要先建立驗證工作階段，引導使用者在行動裝置瀏覽器中完成活體採集，再呼叫 GetVisualValidateResult 取得真人素材群組 ID；工作階段失效後應重新建立。
取得真人素材群組後可以繼續上傳素材，但人臉必須與已驗證人臉一致。不相符的素材會進入失敗狀態並回傳 FaceMismatch。
素材狀態與結果
Processing：素材仍在處理，建議間隔約 3 秒查詢，不要不間斷輪詢。Active：素材可以用於影片生成。Failed：讀取錯誤原因並停止輪詢；修正素材後重新上傳。GetAsset回傳的簽章 URL 有效期限約 11.5 小時，不應作為永久網址儲存或公開散布。
素材與 API Key 所屬帳戶綁定。存取不存在或不屬於目前帳戶的素材時，可能回傳 ResourceNotFound。刪除素材群組會連同群組內的素材一併刪除，操作前應確認目標 ID 和刪除範圍。
相關 API
- 從建立素材群組或建立真人驗證工作階段開始。
- 素材可用後，可前往 Seedance 2.5 原生建立影片或 Seedance 2.0 原生建立影片送出
asset://...引用。