Seedance创建素材API-图片视频音频素材-AutoRouter

在素材组中创建图片、视频或音频素材。素材地址必须公网可访问。

在指定素材组下创建一条素材。assetUrl 必须是公网可访问的 HTTP 或 HTTPS 地址，服务端会从该地址下载文件。素材类型为图片、视频或音频。单个用户最多 10000 条素材。每次请求创建一条，批量创建请逐条调用。

Base URL

https://api.autorouter.top — Production

Authentication

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

Endpoints

POST `/seedance/v1/asset`

创建素材

创建一条素材，成功后 body 返回素材 ID。

Request Body

Content-Type: application/json

Example:

{
  "groupId": "volcano-group-xxx",
  "assetName": "产品介绍视频",
  "assetUrl": "https://example.com/test.mp4",
  "assetType": "Video"
}

Properties:

Name	Type	Required	Description
`groupId`	string	Yes	素材组 ID（火山资产组 ID）
`assetName`	string	Yes	素材名称，最长 64 个字符
`assetUrl`	string	Yes	素材 URL，须为公网可访问的 HTTP 或 HTTPS 地址
`assetType`	string	Yes	素材类型：`Image`（图片）、`Video`（视频）或 `Audio`（音频）

groupIdstring（必选）

素材组 ID（火山资产组 ID）

assetNamestring（必选）

素材名称，最长 64 个字符

示例值：产品介绍视频

assetUrlstring（必选）

素材 URL，须为公网可访问的 HTTP 或 HTTPS 地址

服务端会通过该地址下载素材。请确认链接在请求时可被公网访问。

assetTypestring（必选）

素材类型：Image（图片）、Video（视频）或 Audio（音频）

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

Responses

200: 成功

Content-Type: application/json

请求示例

curl -X POST "https://api.autorouter.top/seedance/v1/asset" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -d '{
  "groupId": "volcano-group-xxx",
  "assetName": "产品介绍视频",
  "assetUrl": "https://example.com/test.mp4",
  "assetType": "Video"
}'

响应示例

{
  "requestId": "1803ae665a704fbd90d20b3d50085033",
  "state": "OK",
  "errorCode": "",
  "errorMessage": "",
  "body": "asset-id"
}

响应字段说明：

Name	Type	Description
`requestId`	string	请求 ID
`state`	string	调用状态。`OK` 表示成功，`ERROR` 表示失败
`errorCode`	string	异常码。成功时为空字符串或 `null`
`errorMessage`	string	异常消息。成功时为空字符串或 `null`
`body`	string	新建素材的 ID

statestring

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

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

bodystring

新建素材的 ID

错误处理

HTTP 状态码为 200 时，仍需检查响应体中的 state。

`state`	说明
`OK`	调用成功，业务数据在 `body`
`ERROR`	调用失败。`errorCode` 为异常码，`errorMessage` 为异常消息

成功时 errorCode 和 errorMessage 可能为空字符串或 null。