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 素材与真人验证.