Skip to main content
這些 Action 讓既有火山素材用戶端保留 Action 名稱、Version=2024-01-01、PascalCase JSON、篩選、排序、分頁及 ResponseMetadata + Result 信封。TokenLab 只替換端點與驗證方式。

端點與驗證

也支援 POST /api/v3?Action=<ACTION>&Version=2024-01-01。所有素材 Action 僅接受 POST。只有 AK/SK 簽名的請求會回傳 401 InvalidCredential ProjectName 預設為 default,並在目前組織內形成真正的隔離邊界。相關建立、列表、讀取、更新和刪除請求必須使用相同值。

素材群組 Action

CreateAssetGroup 只能建立 AIGC 群組。LivenessFace 群組必須在真人驗證成功後建立;ListAssetGroups 可篩選兩種群組。

建立素材群組

素材 Action

AssetType 支援 ImageVideoAudio。目標群組決定素材屬於一般 AIGC 或已驗證的 LivenessFace

建立素材

列表行為

PageNumber 預設為 1PageSize 預設為 10 且最大為 100SortBy 支援 CreateTimeUpdateTimeSortOrder 支援 DescAsc 素材狀態為 ActiveProcessingFailedGetAssetListAssets 回傳有效 12 小時的暫時 URL;請儲存 Id,不要把 URL 當作永久識別。 ListAssetGroupsListAssets 透過 Result.Items 回傳資源,並同時回傳 TotalCountPageNumberPageSize

真人素材

先建立視覺驗證工作階段並完成 H5 驗證,再取得驗證結果回傳的 GroupId,最後以該群組呼叫 CreateAsset。上傳內容會與已驗證人臉比對。
  1. 建立視覺驗證工作階段
  2. 取得視覺驗證結果
  3. 使用回傳的 GroupId 呼叫 CreateAsset

錯誤

錯誤沿用火山回應信封,錯誤碼與訊息位於 ResponseMetadata.Error
InvalidCredential, InvalidVersion, InvalidParameter, NotFound, Conflict, MethodNotAllowed, InternalError.

REST 替代介面

TokenLab 的 /v1/videos/assets* REST 介面仍然可用。新整合可選擇 snake_case REST;既有火山用戶端無須改造請求內容。 Seedance 素材與真人驗證.