doubao-seedance 视频生成调用

视频生成是异步任务，需要两步：

1. 先在终端提交任务拿到 task_id；
2. 再在 Openclaw API 官网侧边栏的任务日志查询任务结果，任务日志提供视频预览以及下载功能。

下面教程给出的终端命令行只需要把 sk-你的令牌 换成你自己的 API KEY 即可直接套用生成模版视频，想要按照自己的想法进行视频生成还需要按照参数说明进行其他的参数修改。

doubao-seedance 支持文生视频、图生视频、视频生视频三种模式，端点和异步两步流程完全一样，区别只在请求体——图生 / 视频生在 metadata.content 里多传一张图或一段参考视频。三种模式的查询进度与等待时间方式相同，见本页最后。

一、文生视频：参数说明

常用可选参数，按照需求进行选择修改：

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "你的画面描述",
  "seconds": "5",               // 视频时长，常用 5 / 10 秒
  "metadata": {
    "resolution": "1080p",      // 分辨率：720p / 1080p
    "ratio": "16:9",            // 画面比例：16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9
    "seed": 12345,              // 随机种子，固定值可复现同一画面（可选）
    "watermark": false,         // 是否打水印（可选，默认 false）
    "camera_fixed": false,      // 是否固定镜头不动（可选）
    "generate_audio": true      // 是否生成配音（可选，默认 true）
  }
}

二、文生视频：调用指令

复制下面命令到终端，修改 prompt 字段为你想要的视频画面描述，修改 seconds 字段为你想要的视频时长，修改 resolution 字段为你想要的视频分辨率，修改 ratio 字段为你想要的视频画面比例，有添加随机种子、水印、关闭配音等需求学习参数说明的格式在 ratio 字段后面进行添加：

curl https://openclaw-api.com/v1/video/generations \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "一只橘猫在江南春日的西湖边漫步，柳枝拂面，湖面波光粼粼，电影质感",
    "seconds": "5",
    "metadata": {
      "resolution": "1080p",
      "ratio": "16:9"
    }
  }'

成功返回示例（其中 task_id 是后续查询的依据）：

{
  "id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "doubao-seedance-2-0-260128",
  "created": 1778680087
}

三、图生视频：参数说明

在文生视频的基础上，往 metadata.content 数组里放一张首帧图（可选再放一张尾帧图），模型会以图为画面起点（或在首尾帧之间补全）生成视频。prompt 仍写在顶层，用来描述画面如何运动：

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "镜头缓缓推进，主体动起来，电影质感",
  "seconds": "5",
  "metadata": {
    "resolution": "1080p",        // 720p / 1080p
    "ratio": "16:9",              // 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9
    "content": [
      {
        "type": "image_url",
        "image_url": { "url": "https://你的首帧图地址.jpg" },
        "role": "first_frame"     // 首帧；如需尾帧再加一条 role 为 "last_frame"
      }
    ]
  }
}

注意

图片地址可以是公网 URL，也可以是 data:image/jpeg;base64,... 形式的 base64。输入图若涉及版权 / 名人 / 受限内容，上游会返回 400 PolicyViolation（input image may be related to copyright restrictions），请更换图片。

四、图生视频：调用指令

把 sk-你的令牌 换成你的 API KEY，把 image_url.url 换成你的首帧图地址即可：

curl https://openclaw-api.com/v1/video/generations \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "镜头缓缓推进，主体动起来，电影质感",
    "seconds": "5",
    "metadata": {
      "resolution": "1080p",
      "ratio": "16:9",
      "content": [
        {
          "type": "image_url",
          "image_url": { "url": "https://你的首帧图地址.jpg" },
          "role": "first_frame"
        }
      ]
    }
  }'

返回与文生视频完全一致，同样拿到 task_id。后续查询进度与等待时间见本页最后（三种模式通用）。

五、视频生视频：参数说明

以一段参考视频为基础生成新视频（风格迁移、二次创作等）。往 metadata.content 里放一个 video_url 条目，role 必须是 reference_video，prompt 写在顶层描述要怎么改：

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "把这段视频转成赛博朋克霓虹夜景风格",
  "seconds": "5",
  "metadata": {
    "resolution": "1080p",
    "ratio": "16:9",
    "content": [
      {
        "type": "video_url",
        "video_url": { "url": "https://你的参考视频地址.mp4" },
        "role": "reference_video"
      }
    ]
  }
}

注意

• 参考视频条目的 role 必须是 reference_video，否则上游报 400 reference media mode requires video role to be reference_video。
• 参考视频不能与首 / 尾帧图混用，否则报 400 first/last frame content cannot be mixed with reference media content。
• 视频生视频会额外按 video_input 倍率计费（seedance-2.0 约 0.61），费用与文 / 图生视频不同。

六、视频生视频：调用指令

curl https://openclaw-api.com/v1/video/generations \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "把这段视频转成赛博朋克霓虹夜景风格",
    "seconds": "5",
    "metadata": {
      "resolution": "1080p",
      "ratio": "16:9",
      "content": [
        {
          "type": "video_url",
          "video_url": { "url": "https://你的参考视频地址.mp4" },
          "role": "reference_video"
        }
      ]
    }
  }'

同样返回 task_id。

七、查询任务进度 / 获取视频 URL

以上文生 / 图生 / 视频生视频三种模式，提交后都用下面方式查询结果——把返回的 task_id 替换进命令：

curl https://openclaw-api.com/v1/video/generations/task_xxxxxxxxxxxx \
  -H "Authorization: Bearer sk-你的令牌"

当返回里 data.status 是 SUCCESS 时，data.result_url 就是视频的下载地址，也可以直接通过任务日志进行视频预览与下载。

注意

视频 URL 以及任务日志视频预览与下载只在任务完成后 24 小时内有效，请及时下载保存。

八、等待时间与进度查看

视频生成大约需要 5–10 分钟，1080p 5 秒视频实测平均约 7–10 分钟出结果。除了上面 curl 主动查询，你也可以直接登录 OpenClaw 后台任务日志页面查看所有视频任务的实时状态、进度百分比与生成结果：

打开任务日志页面 →