API 文档AI 模型接口视频Seedance素材
查询素材详情
按素材 ID 查询详情。返回的素材地址有效期为 12 小时。
按素材 ID 查询单条素材。返回的 assetUrl 是预签名地址，有效期 12 小时，请及时下载或转存。
Base URL
https://api.autorouter.top— Production
Authentication
BearerAuth: http (bearer)
使用 Bearer Token 认证。
格式: Authorization: Bearer sk-xxxxxx
Endpoints
GET /seedance/v1/asset/{assetId}
查询素材详情
返回素材名称、类型、状态和预签名地址。
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
assetId | string | Yes | 素材 ID（火山素材 ID） |
Responses
200: 成功
Content-Type: application/json
请求示例
curl -X GET "https://api.autorouter.top/seedance/v1/asset/{assetId}" \
-H "Authorization: Bearer sk-xxxxxx"响应示例
{
"requestId": "reqId-5d61aca351ffe2837f47bbb06d98fe6c",
"state": "OK",
"errorCode": null,
"errorMessage": null,
"body": {
"assetId": "asset-20260731170718-dbnvv",
"groupId": "group-20260731170706-sbjbr",
"assetName": "1313",
"assetType": "Image",
"assetUrl": "https://ark-media-asset.tos-cn-beijing.volces.com/2125187037/0731:",
"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. | string | 火山素材 ID |
body. | string | 火山资产组 ID |
body. | string | 素材名称 |
body. | string | 素材类型，取值为 Image、Video 或 Audio |
body. | string | 素材预签名 URL，动态生成，有效期 12 小时 |
body. | string | 素材状态，取值为 PROCESSING、ACTIVE 或 FAILED |
body. | string | 错误信息。状态为 FAILED 时返回失败原因 |
body. | string | 创建时间，格式 yyyy-MM-dd HH:mm:ss |
body. | 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。