API 文档AI 模型接口视频Seedance素材
创建素材组
创建 AIGC(虚拟人像)素材组。单个用户最多 10000 个素材组。
创建素材组,用于归集图片、视频和音频素材。本接口只创建 AIGC(虚拟人像)素材组。真人素材库(LivenessFace)要先创建 H5 认证会话,完成认证后再通过 bytedToken 查询素材组。单个用户最多创建 10000 个素材组。
Base URL
https://api.autorouter.top— Production
Authentication
BearerAuth: http (bearer)
使用 Bearer Token 认证。
格式: Authorization: Bearer sk-xxxxxx
Endpoints
POST /seedance/v1/asset-group
创建素材组
创建一个 AIGC 虚拟人像素材组,成功后在 body 中返回素材组信息。
Request Body
Content-Type: application/json
Example:
{
"groupType": "AIGC",
"groupName": "我的AIGC素材组",
"description": "用于数字人视频生成的素材集合"
}Properties:
| Name | Type | Required | Description |
|---|---|---|---|
groupType | string | Yes | 素材组类型。本接口仅支持 AIGC(虚拟人像素材库) |
groupName | string | Yes | 素材组名称,最长 64 个字符 |
description | string | No | 素材组简介,最长 300 个字符 |
groupTypestring(必选)
素材组类型。本接口仅支持 AIGC(虚拟人像素材库)
AIGC:虚拟人像素材库LivenessFace:真人素材库
创建素材组时只能传 AIGC。真人素材库请通过 H5 认证流程创建。
groupNamestring(必选)
素材组名称,最长 64 个字符
示例值:我的AIGC素材组
descriptionstring(可选)
素材组简介,最长 300 个字符
Responses
200: 成功
Content-Type: application/json
请求示例
curl -X POST "https://api.autorouter.top/seedance/v1/asset-group" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxxxxx" \
-d '{
"groupType": "AIGC",
"groupName": "我的AIGC素材组",
"description": "用于数字人视频生成的素材集合"
}'响应示例
{
"requestId": "1803ae665a704fbd90d20b3d50085033",
"state": "OK",
"errorCode": "",
"errorMessage": "",
"body": {
"groupId": "volcano-group-xxx",
"groupType": "AIGC",
"groupName": "我的AIGC素材组",
"description": "用于数字人视频生成的素材集合",
"createdTime": "2026-07-01 17:07:18",
"updatedTime": "2026-07-01 17:07:22"
}
}响应字段说明:
| Name | Type | Description |
|---|---|---|
requestId | string | 请求 ID |
state | string | 调用状态。OK 表示成功,ERROR 表示失败 |
errorCode | string | 异常码。成功时为空字符串或 null |
errorMessage | string | 异常消息。成功时为空字符串或 null |
body | object | 素材组信息 |
body. | string | 火山资产组 ID |
body. | string | 素材组类型,取值为 AIGC 或 LivenessFace |
body. | string | 素材组名称 |
body. | string | 素材组简介 |
body. | string | 创建时间,格式 yyyy-MM-dd HH:mm:ss |
body. | string | 更新时间,格式 yyyy-MM-dd HH:mm:ss |
statestring
调用状态。OK 表示成功,ERROR 表示失败
OK:返回正常ERROR:返回错误,请查看errorCode和errorMessage
bodyobject
素材组信息
groupIdstring
火山资产组 ID
groupTypestring
素材组类型,取值为 AIGC 或 LivenessFace
AIGC:虚拟人像素材库LivenessFace:真人素材库
groupNamestring
素材组名称
descriptionstring
素材组简介
createdTimestring
创建时间,格式 yyyy-MM-dd HH:mm:ss
updatedTimestring
更新时间,格式 yyyy-MM-dd HH:mm:ss
错误处理
HTTP 状态码为 200 时,仍需检查响应体中的 state。
state | 说明 |
|---|---|
OK | 调用成功,业务数据在 body |
ERROR | 调用失败。errorCode 为异常码,errorMessage 为异常消息 |
成功时 errorCode 和 errorMessage 可能为空字符串或 null。