選擇素材工作流程
素材概念
Seedance 素材是可重複使用、以組織為範圍的參考資料，可在影片生成過程中選取。
請區分
group_id 與素材資產 id。group_id 用於組織上傳內容；素材資產 id 用於影片生成。若影片請求回傳 Seedance material asset not found or not accessible，請確認您傳入的是素材資產 id 而非 group_id，且該資產屬於同一組織、未被刪除，且狀態為 status: "ACTIVE"。
自動圖片素材
當所選 Seedance 模型可使用 TokenLab 素材庫時，您可以直接在image、image_url、image_urls、reference_images、start_image 或 end_image 中傳入圖片 URL 或支援的內嵌 data URL。TokenLab 會將這些圖片匯入組織預設的虛擬人像素材群組，並保留其首幀、尾幀或參考圖角色。
如果素材在 60 秒內變為 ACTIVE，同一個請求會繼續進入生成。如果尚未準備完成，API 會回傳 409 seedance_material_preparing 和 auto_material_asset_ids；請查詢這些素材直到它們變為 ACTIVE，再使用 material_asset_id 或 material_asset_ids 重試。如果所選模型暫不可使用素材庫，一般圖片 URL 或 data URL 會繼續走常規圖片路徑；明確傳入素材 ID 會安全失敗，並回傳可重試的素材可用性錯誤。既有虛擬人像素材 ID 和真人素材 ID 會原樣使用，不會重複匯入。
真人素材驗證
當您的產品在將真人作為可重複使用的 Seedance 參考資料前，需要取得同意並進行人臉驗證時，請使用真人素材驗證。- 呼叫 建立視覺驗證會話，傳入
CallbackURL，並儲存回傳的Result.BytedToken。 - 為待驗證人員開啟
Result.H5Link。若需要特定語言，請在 H5 連結後附加lng。 - H5 流程完成後，瀏覽器會開啟
Result.CallbackURL，並帶有bytedToken、resultCode等官方查詢參數。 - 使用
BytedToken輪詢 取得視覺驗證結果，直到回傳Result.GroupId。 - 儲存
GroupId；建立liveness_face素材時將其作為group_id。
BytedToken 的有效期限為 30 分鐘。兩個 Action 請求必須使用相同的 ProjectName。驗證使用 Authorization: Bearer <TOKENLAB_API_KEY>；不接受火山引擎 AK/SK 簽名。
選用：使用 測試控制台 來驗證您的請求與回呼流程、檢查素材群組並查看驗證紀錄。正式環境整合應直接呼叫 API。
建立素材群組
針對aigc_avatar 群組，請使用 建立素材資產群組。新的真人素材群組是透過驗證流程建立的，以確保已驗證的人物與素材群組保持連結。
使用 列出素材資源群組、取得素材資源群組、更新素材資產群組 和 刪除素材資源群組 來管理現有的群組。
刪除素材群組會同時刪除其中的 TokenLab 素材，且無法復原。若 TokenLab 素材庫因目前的授權狀態不允許而無法完成刪除，TokenLab 將回傳中性的素材庫錯誤。
上傳素材
使用 建立素材資產 每次匯入一個可公開存取的來源 URL。 對於aigc_avatar，group_id 為選填；TokenLab 會使用或建立組織預設的虛擬人像群組。對於 liveness_face，group_id 為必填，且必須是 取得視覺驗證結果 所回傳的群組。
素材擷取為非同步處理。請輪詢 取得素材資源 (Get Material Asset) 直到
status 變為 ACTIVE。成功的 HTTP 回應僅代表請求已被接受；請務必讀取業務狀態。若狀態為 FAILED，請檢查 error_message，修正來源素材並建立新資產。
在建立素材請求中，asset_url 只表示匯入來源。TokenLab 會回傳素材資產 id；產生影片時請使用這個 id，不要繼續使用原始 URL。
TokenLab 會將素材保留在您的組織素材庫中，直到您刪除該素材或其所在素材群組。
對於真人素材群組，一個群組對應一位真人。上傳內容會與已驗證的人臉進行比對。包含多張人臉或人臉與已驗證人物不符的資產可能會失敗。為獲得最佳效果，請同時上傳全身正面參考圖與臉部清晰的正面特寫照。
在影片生成中使用素材
當資產狀態為ACTIVE 後，在呼叫 建立影片 時，將回傳的 TokenLab 資產 id 作為 material_asset_id 傳入，或包含在 material_asset_ids 中。素材資產會計入 Seedance 參考限制。
REST 或火山 Action
TokenLab 原生整合可繼續使用 snake_case 的/v1/videos/assets* REST 介面。既有火山用戶端可保留 PascalCase 請求內容並使用火山相容素材 Action。兩套介面操作同一份組織與專案範圍內的素材資料。
API 範例
建立一個虛擬人像群組、上傳圖片、輪詢直到其啟用，然後在影片請求中使用該素材資產 ID。完整的真人 Action 流程
取得驗證結果回傳的GroupId 後，將它傳給 CreateAsset：
GetAsset 直到狀態變成 Active，再於影片生成中使用回傳的素材 ID。