1 上传素材接口（支持 AIGC 真人）

POST https://ai-api.mandao.com/v1/video/seedance/assets/upload

用途：将外部 URL 指向的素材（图片 / 视频 / 音频）上传到上游素材库，落库后获得稳定的 asset_id，可在创建视频任务时通过 content[].image_url.url 等字段引用。

1.1请求头

• Content-Type: application/json
• Authorization: Bearer $ARK_API_KEY

1.2 必传 Query 参数

1.3 请求体字段

1.4 请求示例

curl -X POST 'https://ai-api.mandao.com/v1/video/seedance/assets/upload?model=doubao-seedance-2-0-fast' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -d '{
    "url": "https://example.com/lion.jpg",
    "asset_type": "Image",
    "name": "lion01"
  }'

1.5 响应字段

1.6 响应示例

{
  "code": 0,
  "message": "ok",
  "data": {
    "Id": "asset-20260507175358-hmw2h"
  }
}

1.7 错误说明

• 缺失 ?model ：HTTP 400
• 缺失 url / asset_type：HTTP 400
• 上游 URL 命中 SSRF 黑名单（启用 SSRF 防护时）：HTTP 400
• 上游接口失败：原样回传上游 HTTP 状态码与错误体

2 查询单个素材接口（支持 AIGC 真人）

GET https://ai-api.mandao.com/v1/video/seedance/assets/{asset_id}

用途：查询素材当前状态、签名 URL 等元信息

2.1请求头

• Authorization: Bearer $ARK_API_KEY

2.2 路径参数

2.3 必传 Query 参数

2.4 所有权语义

调用方必须是该 asset_id 的上传者（即上传时使用的 token 所属 user）。

• 命中：返回结果
• 未命中：返回 HTTP 404

2.5 请求示例

curl 'https://ai-api.mandao.com/v1/video/seedance/assets/asset-20260507175358-hmw2h?model=doubao-seedance-2.0' \
  -H "Authorization: Bearer $ARK_API_KEY"

2.6 响应字段

2.7 响应示例

{
  "code": 0,
  "message": "ok",
  "data": {
    "Id": "asset-20260507175358-hmw2h",
    "Name": "lion01",
    "AssetType": "Image",
    "Status": "Active",
    "URL": "https://cdn.example.com/asset-...?Signature=...",
    "CreateTime": "2026-05-07T17:53:58Z"
  }
}

2.8 错误说明

• asset_id 不符合 [a-zA-Z0-9_\-]+：HTTP 400
• 当前 token 不是该 asset_id 的上传者：HTTP 404
• 缺失 ?model ：HTTP 400

3 使用素材创建视频

当成功将素材上传至素材库中后，可使用 asset_id 创建视频任务。

⚠️ 注意：image_url 中的 url 参数是可通过 asset:// + asset_id 拼接的（真人参考图请优先使用该方式，否则可能触发敏感风控），也可传入常规的 https 链接。

3.1 请求示例

{
  "model": "doubao-seedance-2.0",
  "content": [
    {
      "type": "text",
      "text": "一只猫在海边奔跑，电影感，夕阳，4k"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "asset://asset-20260507175358-hmw2h"
      },
      "role": "reference_image"
    }
  ],
  "ratio": "16:9",
  "duration": 4,
  "resolution": "720p",
  "execution_expires_after": 3600,
  "watermark": false
}