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。上传内容会与已验证的人脸比对。
错误
错误继续使用火山响应信封,错误码和消息位于ResponseMetadata.Error。
InvalidCredential, InvalidVersion, InvalidParameter, NotFound, Conflict, MethodNotAllowed, InternalError.
REST 替代接口
TokenLab 的/v1/videos/assets* REST 接口继续可用。新接入可选择 snake_case REST;已有火山客户端无需改造请求体。 Seedance 素材与真人验证.