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:

NameTypeRequiredDescription
groupTypestringYes素材组类型。本接口仅支持 AIGC(虚拟人像素材库)
groupNamestringYes素材组名称,最长 64 个字符
descriptionstringNo素材组简介,最长 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"
  }
}

响应字段说明:

NameTypeDescription
requestIdstring请求 ID
statestring调用状态。OK 表示成功,ERROR 表示失败
errorCodestring异常码。成功时为空字符串或 null
errorMessagestring异常消息。成功时为空字符串或 null
bodyobject素材组信息
body.groupIdstring火山资产组 ID
body.groupTypestring素材组类型,取值为 AIGC 或 LivenessFace
body.groupNamestring素材组名称
body.descriptionstring素材组简介
body.createdTimestring创建时间,格式 yyyy-MM-dd HH:mm:ss
body.updatedTimestring更新时间,格式 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。

目录