Seedance查询素材组列表API-素材库-AutoRouter

分页查询当前用户的素材组。可以按素材组类型、名称关键字和组 ID 列表过滤。pageNo 从 1 开始，pageSize 最大为 100。

Base URL

https://api.autorouter.top — Production

Authentication

BearerAuth: http (bearer) 使用 Bearer Token 认证。格式: Authorization: Bearer sk-xxxxxx

Endpoints

POST `/seedance/v1/asset-group/query`

查询素材组列表

按条件分页返回素材组列表和总条数。

Request Body

Content-Type: application/json

Example:

{
  "pageNo": 1,
  "pageSize": 10,
  "groupType": "AIGC"
}

Properties:

Name	Type	Required	Description
`pageNo`	integer	Yes	页码，从 1 开始
`pageSize`	integer	Yes	每页条数，最大 100
`groupType`	string	No	按素材组类型过滤。不传则不过滤
`groupName`	string	No	素材组名称模糊搜索关键字，最长 64 个字符。不传则不过滤
`groupIds`	string[]	No	素材组 ID 列表，按 ID 精确查询。不传则不过滤

pageNointeger（必选）

页码，从 1 开始

pageSizeinteger（必选）

每页条数，最大 100

最大为 100。

groupTypestring（可选）

按素材组类型过滤。不传则不过滤

AIGC：虚拟人像素材库
LivenessFace：真人素材库

不传则不过滤类型。

groupNamestring（可选）

素材组名称模糊搜索关键字，最长 64 个字符。不传则不过滤

groupIdsstring[]（可选）

素材组 ID 列表，按 ID 精确查询。不传则不过滤

Responses

200: 成功

Content-Type: application/json

请求示例

curl -X POST "https://api.autorouter.top/seedance/v1/asset-group/query" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -d '{
  "pageNo": 1,
  "pageSize": 10,
  "groupType": "AIGC"
}'

响应示例

{
  "requestId": "reqId-7532f8f1-122a-4a69-b19e-b0a9f1d8d7f4",
  "state": "OK",
  "errorCode": "",
  "errorMessage": "",
  "body": {
    "data": [
      {
        "groupId": "volcano-group-xxx",
        "groupType": "AIGC",
        "groupName": "我的AIGC素材组",
        "description": "用于数字人视频生成的素材集合",
        "createdTime": "2026-07-01 17:07:18",
        "updatedTime": "2026-07-01 17:07:22"
      }
    ],
    "total": 1
  }
}

响应字段说明：

Name	Type	Description
`requestId`	string	请求 ID
`state`	string	调用状态。`OK` 表示成功，`ERROR` 表示失败
`errorCode`	string	异常码。成功时为空字符串或 `null`
`errorMessage`	string	异常消息。成功时为空字符串或 `null`
`body`	object	分页结果
`body.data`	object[]	`data` 为当前页的素材组列表
`body.data[].groupId`	string	火山资产组 ID
`body.data[].groupType`	string	素材组类型，取值为 `AIGC` 或 `LivenessFace`
`body.data[].groupName`	string	素材组名称
`body.data[].description`	string	素材组简介
`body.data[].createdTime`	string	创建时间，格式 `yyyy-MM-dd HH:mm:ss`
`body.data[].updatedTime`	string	更新时间，格式 `yyyy-MM-dd HH:mm:ss`
`body.total`	integer	符合条件的总条数

statestring

调用状态。OK 表示成功，ERROR 表示失败

OK：返回正常
ERROR：返回错误，请查看 errorCode 和 errorMessage

bodyobject

分页结果

data 为当前页的素材组列表

符合条件的总条数

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。

查询素材组列表