API 开发者文档

SEEDANCE COMPATIBLE

视频生成与资源库 API

面向 Agent、SDK 与后端服务的统一接入说明。使用 Bearer Token 调用视频生成与资源库；资源素材可通过 asset:// 直接引用到视频任务。

打开 API 测试工具 直接配置网关与 Token，在线调试视频任务和资源库接口
视频 Base URL <VIDEO_BASE_URL>
资源库 Base URL <ASSET_BASE_URL>
鉴权 Authorization: Bearer <API_KEY>

VIDEO

概览

视频请求保持 Seedance 的字段结构。视频任务使用 Bearer Token 认证；网关将任务和账单按 Token 隔离，调用方只能读取或取消自己的任务。

方法路径用途
POST/api/v3/contents/generations/tasks创建视频生成任务
GET/api/v3/contents/generations/tasks/{id}查询单个任务
GET/api/v3/contents/generations/tasks查询任务列表
DELETE/api/v3/contents/generations/tasks/{id}取消或删除任务

创建任务

使用 POST 提交 JSON。content 至少需要一项文本或媒体输入；duration 与 frames 二选一，指定 frames 时优先使用帧数。

model必填。模型标识。
content必填。文本、图片、视频、音频或草稿任务。
resolution可选。常用 720p、1080p、4k。
ratio可选。支持 16:9、9:16、adaptive 等。
generate_audio可选。生成同步音频。
watermark可选。是否添加 AI 生成水印。
文生视频
curl -sS -X POST "$VIDEO_BASE_URL/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "content": [{"type": "text", "text": "雨后的城市街道，电影感镜头缓慢推进"}],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": true,
    "watermark": false
  }'

查询单任务与任务列表

创建成功会返回 id。使用该 ID 轮询单任务直到进入 succeeded、failed、cancelled 或 expired。

轮询单任务
curl -sS "$VIDEO_BASE_URL/api/v3/contents/generations/tasks/$TASK_ID" \
  -H "Authorization: Bearer $API_KEY"
列表参数page 或 page_num 指定页码，page_size 指定页大小。返回结构为 {"items": [...], "total": N}。

取消与删除

对排队任务执行 DELETE 会取消任务；已成功、失败或超时的任务可删除。运行中的任务与已取消任务通常会返回 4xx。

取消或删除
curl -sS -X DELETE "$VIDEO_BASE_URL/api/v3/contents/generations/tasks/$TASK_ID" \
  -H "Authorization: Bearer $API_KEY"

引用资源库素材

当资源库中的 Asset 状态为 Active 后，使用 asset://<asset_id> 作为媒体 URL。素材必须属于当前账户。

图生视频
{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {"type": "text", "text": "人物转身看向镜头，镜头自然跟随"},
    {
      "type": "image_url",
      "image_url": {"url": "asset://asset-..."},
      "role": "reference_image"
    }
  ],
  "duration": 5,
  "resolution": "1080p",
  "ratio": "9:16"
}

响应与注意事项

401

Token 缺失、无效或已吊销。

403

访问其他账户的任务或资源。

409

取消运行中或已取消的任务。

429

额度、并发或上游速率限制。

视频 URL 属于临时签名地址，应在生成成功后及时下载或转存。callback_url 不用于回调通知，建议以轮询获取最终结果。