上传素材

OpenAPI Specification

上传素材（图片、视频等）并取得素材 ID；待素材就绪（Active）后，即可在生成接口中以 asset://{素材id} 引用。素材 ID 长期留存，适合反复引用同一角色。

请求方式：POST

接口地址

https://api.allyang.cn/seedance/v3/assets/create

请求头

• Content-Type（必填）：请求体类型，按本页标注填写。（示例：application/json）
• Authorization（可选）：鉴权头，使用控制台创建的令牌，格式为 Bearer + 令牌。（示例：Bearer {{YOUR_API_KEY}}）

请求参数（application/json）

• url（string，必填）
• assetType（string，必填）
  • 可选值：Image、Video、Audio。

请求示例

{
  "url": "https://example.com/…",
  "assetType": "Image"
}

返回字段

• code（integer，必填）
• msg（string，必填）
• errorMessages（null，可选）
• data（object，必填）
  • assetId（string，必填）
  • status（string，必填）

返回示例

{
  "code": 0,
  "msg": "success",
  "errorMessages": null,
  "data": {
    "assetId": "asset-20260409211407-mwmd8",
    "status": "Processing"
  }
}

使用提示：素材未就绪时引用会失败，请先查询素材状态。