Seedance Update Asset API

Update an asset name. Only assets in the ACTIVE status can be changed. assetName is at most 64 characters; omit it to leave the name unchanged.

Base URL

https://api.autorouter.top — Production

Authentication

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

Endpoints

PUT `/seedance/v1/asset/{assetId}`

Update Asset

Update the asset name and return the updated asset.

Path Parameters

Name	Type	Required	Description
`assetId`	string	Yes	Asset ID (Volcano asset ID)

Request Body

Content-Type: application/json

Example:

{
  "assetName": "产品介绍视频-新版"
}

Properties:

Name	Type	Required	Description
`assetName`	string	No	Asset name, up to 64 characters. Omit to leave unchanged

assetNamestring(Optional)

Asset name, up to 64 characters. Omit to leave unchanged

Only assets in the ACTIVE status can be renamed.

Responses

200: Success

Content-Type: application/json

Request examples

curl -X PUT "https://api.autorouter.top/seedance/v1/asset/{assetId}" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -d '{
  "assetName": "产品介绍视频-新版"
}'

Response examples

{
  "requestId": "reqId-b6626d5037a4f53376cd1dad8eb1f179",
  "state": "OK",
  "errorCode": null,
  "errorMessage": null,
  "body": {
    "assetId": "asset-20260728104223-sm8tq",
    "groupId": "group-20260728104222-7xprw",
    "assetName": "产品介绍视频-新版",
    "assetType": "Image",
    "assetUrl": "https://eos-wuxi-5.cmecloud.cn/maas.exp/asset/2120555353/group-202...",
    "status": "ACTIVE",
    "createdTime": "2026-07-01 17:07:18",
    "updatedTime": "2026-07-01 17:07:22"
  }
}

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	Asset
`body.assetId`	string	Volcano asset ID
`body.groupId`	string	Volcano asset group ID
`body.assetName`	string	Asset name
`body.assetType`	string	Asset type: `Image`, `Video`, or `Audio`
`body.assetUrl`	string	Presigned asset URL, generated dynamically and valid for 12 hours
`body.status`	string	Asset status: `PROCESSING`, `ACTIVE`, or `FAILED`
`body.errorMessage`	string	Error message. Present when status is `FAILED`
`body.createdTime`	string	Creation time, format `yyyy-MM-dd HH:mm:ss`
`body.updatedTime`	string	Update time, format `yyyy-MM-dd HH:mm:ss`

statestring

Call status. OK means success, ERROR means failure

OK: Success
ERROR: Failure. Check errorCode and errorMessage

bodyobject

Asset

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.

Update Asset

assetNamestring(Optional)

statestring

bodyobject

Properties

On this page