Seedance List Asset Groups API

Page through asset groups owned by the current user. Filter by group type, a name keyword, or a list of group IDs. pageNo starts at 1, and pageSize is at most 100.

Base URL

https://api.autorouter.top — Production

Authentication

BearerAuth: http (bearer) Authenticate using a Bearer Token. Format: Authorization: Bearer sk-xxxxxx

Endpoints

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

List Asset Groups

Return a page of asset groups and the total count.

Request Body

Content-Type: application/json

Example:

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

Properties:

Name	Type	Required	Description
`pageNo`	integer	Yes	Page number, starting from 1
`pageSize`	integer	Yes	Page size, maximum 100
`groupType`	string	No	Filter by asset group type. Omit to skip this filter
`groupName`	string	No	Fuzzy keyword for the group name, up to 64 characters. Omit to skip this filter
`groupIds`	string[]	No	Asset group ID list for an exact match. Omit to skip this filter

pageNointeger(Required)

Page number, starting from 1

pageSizeinteger(Required)

Page size, maximum 100

Maximum is 100.

groupTypestring(Optional)

Filter by asset group type. Omit to skip this filter

AIGC: Virtual portrait library
LivenessFace: Real-person library

Omit this field to skip type filtering.

groupNamestring(Optional)

Fuzzy keyword for the group name, up to 64 characters. Omit to skip this filter

groupIdsstring[](Optional)

Asset group ID list for an exact match. Omit to skip this filter

Responses

200: Success

Content-Type: application/json

Request examples

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"
}'

Response examples

{
  "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
  }
}

Response fields:

Name	Type	Description
`requestId`	string	Request ID
`state`	string	Call status. `OK` means success, `ERROR` means failure
`errorCode`	string	Error code. Empty string or `null` on success
`errorMessage`	string	Error message. Empty string or `null` on success
`body`	object	Paginated result
`body.data`	object[]	`data` is the asset groups on this page
`body.data[].groupId`	string	Volcano asset group ID
`body.data[].groupType`	string	Asset group type: `AIGC` or `LivenessFace`
`body.data[].groupName`	string	Asset group name
`body.data[].description`	string	Asset group description
`body.data[].createdTime`	string	Creation time, format `yyyy-MM-dd HH:mm:ss`
`body.data[].updatedTime`	string	Update time, format `yyyy-MM-dd HH:mm:ss`
`body.total`	integer	Total number of matched records

statestring

Call status. OK means success, ERROR means failure

OK: Success
ERROR: Failure. Check errorCode and errorMessage

bodyobject

Paginated result

data is the asset groups on this page

Total number of matched records

groupIdstring

Volcano asset group ID

groupTypestring

Asset group type: AIGC or LivenessFace

AIGC: Virtual portrait library
LivenessFace: Real-person library

groupNamestring

Asset group name

descriptionstring

Asset group description

createdTimestring

Creation time, format yyyy-MM-dd HH:mm:ss

updatedTimestring

Update time, format yyyy-MM-dd HH:mm:ss

Error handling

When the HTTP status is 200, still check state in the response body.

`state`	Description
`OK`	The call succeeded. Business data is in `body`
`ERROR`	The call failed. `errorCode` is the error code and `errorMessage` is the error message

On success, errorCode and errorMessage may be an empty string or null.

List Asset Groups