Seedance更新素材API-素材库-AutoRouter

更新素材名称。只有状态为 ACTIVE 的素材可以修改。assetName 最长 64 个字符；不传则不修改。

Base URL

https://api.autorouter.top — Production

Authentication

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

Endpoints

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

更新素材

更新素材名称，并返回更新后的素材信息。

Path Parameters

Name	Type	Required	Description
`assetId`	string	Yes	素材 ID（火山素材 ID）

Request Body

Content-Type: application/json

Example:

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

Properties:

Name	Type	Required	Description
`assetName`	string	No	素材名称，最长 64 个字符。不传则不更新

assetNamestring（可选）

素材名称，最长 64 个字符。不传则不更新

仅 ACTIVE 状态的素材可以修改名称。

Responses

200: 成功

Content-Type: application/json

请求示例

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

响应示例

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

响应字段说明：

Name	Type	Description
`requestId`	string	请求 ID
`state`	string	调用状态。`OK` 表示成功，`ERROR` 表示失败
`errorCode`	string	异常码。成功时为空字符串或 `null`
`errorMessage`	string	异常消息。成功时为空字符串或 `null`
`body`	object	素材信息
`body.assetId`	string	火山素材 ID
`body.groupId`	string	火山资产组 ID
`body.assetName`	string	素材名称
`body.assetType`	string	素材类型，取值为 `Image`、`Video` 或 `Audio`
`body.assetUrl`	string	素材预签名 URL，动态生成，有效期 12 小时
`body.status`	string	素材状态，取值为 `PROCESSING`、`ACTIVE` 或 `FAILED`
`body.errorMessage`	string	错误信息。状态为 `FAILED` 时返回失败原因
`body.createdTime`	string	创建时间，格式 `yyyy-MM-dd HH:mm:ss`
`body.updatedTime`	string	更新时间，格式 `yyyy-MM-dd HH:mm:ss`

statestring

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

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

bodyobject

素材信息

assetIdstring

火山素材 ID

groupIdstring

火山资产组 ID

assetNamestring

素材名称

assetTypestring

素材类型，取值为 Image、Video 或 Audio

Image：图片
Video：视频
Audio：音频

assetUrlstring

素材预签名 URL，动态生成，有效期 12 小时

statusstring

素材状态，取值为 PROCESSING、ACTIVE 或 FAILED

PROCESSING：处理中
ACTIVE：可用
FAILED：失败

errorMessagestring

错误信息。状态为 FAILED 时返回失败原因

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。

更新素材

assetNamestring（可选）

statestring

bodyobject

属性

目录