模型 API / 视频生成

视频生成

更新时间：2026-07-16

接口说明

根据文本提示词（或首帧图像）异步生成视频。视频生成耗时较长，采用「提交任务 → 轮询结果」两步式：先 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，用于图生视频；不传则为文生视频
seconds	string	可选	视频时长（秒），如 "5"；上限 3600，具体取值依模型而定
metadata	object	可选	厂商透传参数，如 resolution（480p/720p/1080p/4k）、ratio（如 16:9）、watermark 等

提交任务

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

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

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.wangyidaai.net/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"
  }
}

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