doubao-seedance 视频生成调用

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

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

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

一、参数说明

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

{
  "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
}

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

把上一步返回的 task_id 替换进下面命令：

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

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

四、等待时间与进度查看

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

打开任务日志页面 →