Version=2024-01-01、PascalCase JSON 和 ResponseMetadata + Result 响应结构,只需更换接口地址和鉴权方式。
接口与鉴权
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 接口
也可以使用 snake_case 的/v1/videos/assets* REST 接口。完整用法见 Seedance 素材与真人验证。