Seedance List Assets API

Page through assets. Filter by group ID, group type, asset name, and status. pageNo starts at 1, and groupType is required.

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/query`

List Assets

Return a page of assets 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
`groupIds`	string[]	No	Asset group ID list for an exact match. Omit to skip this filter
`groupType`	string	Yes	Asset group type. `AIGC` (virtual portrait library) or `LivenessFace` (real-person library)
`assetName`	string	No	Fuzzy keyword for the asset name, up to 64 characters. Omit to skip this filter
`statuses`	string[]	No	Asset status list. Omit to skip this filter

pageNointeger(Required)

Page number, starting from 1

pageSizeinteger(Required)

Page size

groupIdsstring[](Optional)

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

groupTypestring(Required)

Asset group type. AIGC (virtual portrait library) or LivenessFace (real-person library)

AIGC: Virtual portrait library
LivenessFace: Real-person library

Required when listing assets. Both AIGC and LivenessFace can be queried.

assetNamestring(Optional)

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

statusesstring[](Optional)

Asset status list. Omit to skip this filter

PROCESSING: Processing
ACTIVE: Active
FAILED: Failed

Omit this field to skip status filtering. When status is FAILED, errorMessage explains the failure.

Responses

200: Success

Content-Type: application/json

Request examples

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

Response examples

{
  "requestId": "reqId-4cdb2e42e2708ea73506414fbb3fd4a3",
  "state": "OK",
  "errorCode": null,
  "errorMessage": null,
  "body": {
    "data": [
      {
        "assetId": "asset-20260731170718-dgnvv",
        "groupId": "group-20260731170706-spjbr",
        "assetName": "1313",
        "assetType": "Image",
        "assetUrl": "https://ark-media-asset.tos-cn-beijing.volces.com/21351870",
        "status": "ACTIVE",
        "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 assets on this page
`body.data[].assetId`	string	Volcano asset ID
`body.data[].groupId`	string	Volcano asset group ID
`body.data[].assetName`	string	Asset name
`body.data[].assetType`	string	Asset type: `Image`, `Video`, or `Audio`
`body.data[].assetUrl`	string	Presigned asset URL, generated dynamically and valid for 12 hours
`body.data[].status`	string	Asset status: `PROCESSING`, `ACTIVE`, or `FAILED`
`body.data[].errorMessage`	string	Error message. Present when status is `FAILED`
`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 assets on this page

Total number of matched records

assetIdstring

Volcano asset ID

groupIdstring

Volcano asset group ID

assetNamestring

Asset name

assetTypestring

Asset type: Image, Video, or Audio

Image: Image
Video: Video
Audio: Audio

assetUrlstring

Presigned asset URL, generated dynamically and valid for 12 hours

statusstring

Asset status: PROCESSING, ACTIVE, or FAILED

PROCESSING: Processing
ACTIVE: Active
FAILED: Failed

errorMessagestring

Error message. Present when status is FAILED

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 Assets