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 支援 Image、Video 和 Audio。目標群組決定素材屬於一般 AIGC 或已驗證的 LivenessFace。
建立素材
列表行為
PageNumber 預設為 1,PageSize 預設為 10 且最大為 100。SortBy 支援 CreateTime 或 UpdateTime;SortOrder 支援 Desc 或 Asc。
素材狀態為 Active、Processing 或 Failed。GetAsset 和 ListAssets 回傳有效 12 小時的暫時 URL;請儲存 Id,不要把 URL 當作永久識別。
ListAssetGroups 和 ListAssets 透過 Result.Items 回傳資源,並同時回傳 TotalCount、PageNumber 和 PageSize。
真人素材
先建立視覺驗證工作階段並完成 H5 驗證,再取得驗證結果回傳的GroupId,最後以該群組呼叫 CreateAsset。上傳內容會與已驗證人臉比對。
- 建立視覺驗證工作階段
- 取得視覺驗證結果
- 使用回傳的
GroupId呼叫CreateAsset
錯誤
錯誤沿用火山回應信封,錯誤碼與訊息位於ResponseMetadata.Error。
InvalidCredential, InvalidVersion, InvalidParameter, NotFound, Conflict, MethodNotAllowed, InternalError.
REST 替代介面
TokenLab 的/v1/videos/assets* REST 介面仍然可用。新整合可選擇 snake_case REST;既有火山用戶端無須改造請求內容。 Seedance 素材與真人驗證.