模型 API / 视频生成

视频生成

更新时间：2026-07-29

接口说明

根据文本提示词（或首帧图像）异步生成视频。视频生成耗时较长，采用「提交任务 → 轮询结果」两步式：先 POST 提交任务拿到 task_id，再按 task_id 轮询直到状态变为 completed。

POST/video/generations

请求参数

参数	类型	必需	说明
model	string	必需	视频模型 ID，如 doubao-seedance-2-0-260128、doubao-seedance-1-0-pro-250528
prompt	string	必需	视频描述词，中英文均可
image	string	可选	首帧图像 URL 或 Base64，用于图生视频；不传则为文生视频
duration	integer	可选	视频时长（秒），如 5；传 -1 表示由模型智能决定时长。具体取值范围依模型而定
resolution	string	可选	输出分辨率：480p / 720p / 1080p / 4k，不传则用模型默认档
ratio	string	可选	画面宽高比：16:9 / 9:16 / 1:1 / 3:4 / 4:3 / 21:9 / adaptive（默认 adaptive，按提示词自动选）
generate_audio	boolean	可选	是否生成同步音频（人声 / 音效 / 背景音乐），默认 true
content	array	可选	多模态输入数组，元素为 { type: text \| image_url \| video_url \| audio_url }。用它可传视频 / 音频参考；仅文生视频时用 prompt 即可
seed / watermark / camera_fixed	-	可选	其余官方生成参数原样透传，字段名与豆包官方一致

提交任务

提交成功后返回任务对象，status 初始为 queued，请记录 id（即 task_id）用于后续查询。

curl -X POST "https://www.tokenwell.com.cn/v1/video/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "一只银色的狼在月光下的雪原上奔跑，电影级镜头",
    "duration": 5,
    "resolution": "1080p",
    "ratio": "16:9",
    "generate_audio": true
  }'

JSON

{
  "id": "video_7xN3f2k...",
  "task_id": "video_7xN3f2k...",
  "object": "video",
  "model": "doubao-seedance-2-0-260128",
  "status": "queued",
  "progress": 0,
  "created_at": 1708502400
}

查询结果

GET/video/generations/{task_id}

用提交时拿到的 task_id 轮询任务状态。status 会经历 queued → in_progress → completed（或 failed）。建议每 5～10 秒轮询一次；成功后视频地址在 metadata.url 中。

curl "https://www.tokenwell.com.cn/v1/video/generations/video_7xN3f2k..." \
  -H "Authorization: Bearer YOUR_API_KEY"

JSON

{
  "id": "video_7xN3f2k...",
  "task_id": "video_7xN3f2k...",
  "object": "video",
  "model": "doubao-seedance-2-0-260128",
  "status": "completed",
  "progress": 100,
  "created_at": 1708502400,
  "completed_at": 1708502460,
  "metadata": {
    "url": "https://cdn.tokenwell.ai/videos/abc123.mp4"
  }
}

没有找到想看的内容？联系我们 →