创建豆包原生任务

功能说明

文生视频从提示词生成场景；首帧/首尾帧控制视频开始和结束的画面；多模态参考用于保持素材风格、动作或声音；视频编辑修改已有视频，视频延长增加前后内容。样片用于先预览效果，再生成正式成片，属于单独的 1.5 Pro 流程。

第一步：鉴权

在控制台 API 密钥取得青云 API Key。每次创建、查询和下载请求都发送以下请求头：

Authorization: Bearer YOUR_API_KEY

将 YOUR_API_KEY 替换为自己的 Key，保留 Bearer 和其后一个空格。无需先请求登录接口。

第二步：调用模型生成

POST https://top.qingyuntop.ai/doubao/api/v3/contents/generations/tasks

请求头另加 Content-Type: application/json。创建返回 id 后，使用查询任务等待 succeeded，并下载视频。

基础参数

生成选项

这些字段放在请求体顶层，无需 metadata 包裹。

参数是否可用由所选模型决定；同一参数不一定适用于所有模型。不要把 seed、camera_fixed、draft 同时套用到所有 2.0/2.5 请求。

文生视频代码

cURL 使用 Bash 语法；Python 先安装 requests；Node.js 使用 22+ 并保存为 .mjs。示例中的 Key、素材 URL 和任务 ID 都需要替换。

curl --fail-with-body "https://top.qingyuntop.ai/doubao/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "doubao-seedance-2-5-260628",
  "content": [
    {
      "type": "text",
      "text": "一只橙色的猫走过雨后屋顶，镜头缓慢推进，柔和的傍晚光线，伴随轻微雨声。"
    }
  ],
  "duration": 5,
  "resolution": "720p",
  "ratio": "16:9",
  "generate_audio": true
}'

图生与首尾帧

下面 JSON 可直接替换上面的请求体。素材 URL 需要替换，2.5 的首尾帧必须 ratio: adaptive。只用首帧时删除 last_frame 项。

{
  "model": "doubao-seedance-2-5-260628",
  "content": [
    {
      "type": "text",
      "text": "让画面从首帧平滑过渡到尾帧，保持主体外观，镜头缓慢推进。"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/first.png"
      },
      "role": "first_frame"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/last.png"
      },
      "role": "last_frame"
    }
  ],
  "duration": 5,
  "resolution": "720p",
  "ratio": "adaptive"
}

视频和音频参考

参考模式的图片角色使用 reference_image，不使用 first_frame。2.5 可以仅有音频输入；2.0 音频必须搭配图片或视频。

{
  "model": "doubao-seedance-2-5-260628",
  "content": [
    {
      "type": "text",
      "text": "参考视频中的镜头运动和音频的节奏，生成一段产品展示视频。"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://example.com/reference.mp4"
      },
      "role": "reference_video"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://example.com/music.mp3"
      },
      "role": "reference_audio"
    }
  ],
  "omni_reference_task_type": "reference",
  "duration": 5,
  "resolution": "720p",
  "ratio": "16:9",
  "generate_audio": true
}

官方素材限制：单图小于 30 MB，宽高 300–6000 px、宽高比 0.4–2.5；视频 MP4/MOV、单个 ≤200 MB；音频 WAV/MP3、单个 ≤15 MB；请求体 ≤64 MB。青云实际网关也可能施加更小的请求体限制。图片使用 data URL 时保留 data:image/…;base64, 前缀，视频和音频示例使用 HTTPS 文件地址。

Seedance 2.5 视频编辑与延长

编辑修改参考视频：content 至少一个 reference_video，提示词明确修改要求，使用下列完整请求体。模型仍会根据提示词判定任务，判定与指定类型不符可能异步失败。

{
  "model": "doubao-seedance-2-5-260628",
  "content": [
    {
      "type": "text",
      "text": "编辑参考视频，将背景改为傍晚海滩，保持主体动作和镜头顺序。"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://example.com/source.mp4"
      },
      "role": "reference_video"
    }
  ],
  "omni_reference_task_type": "edit",
  "duration": -1,
  "ratio": "adaptive",
  "resolution": "720p"
}

延长视频：将 omni_reference_task_type 改为 extend，保持 ratio: adaptive，并把提示词改为“延续参考视频结尾的动作……”。可使用 duration: -1 由模型决定时长；不要把任意视频的任务 ID 填入 draft_task。

Seedance 1.5 Pro 样片转正式视频

先创建样片，等待 succeeded：

{
  "model": "doubao-seedance-1-5-pro-251215",
  "content": [
    {
      "type": "text",
      "text": "一只橙色的猫走过雨后屋顶，镜头缓慢推进，柔和的傍晚光线，伴随轻微雨声。"
    }
  ],
  "duration": 5,
  "ratio": "16:9",
  "resolution": "480p",
  "draft": true
}

确认效果后，将返回的青云样片 ID 替换 task_draft_example，创建正式视频。请原样使用创建响应中的 ID，来源必须是同账号可访问的样片任务。

{
  "model": "doubao-seedance-1-5-pro-251215",
  "content": [
    {
      "type": "draft_task",
      "draft_task": {
        "id": "task_draft_example"
      }
    }
  ],
  "resolution": "720p",
  "draft": false
}

这是复用样片输入生成正式成片，不是视频延长。正式请求无需重填 prompt 或 duration。样片转正式视频请使用本页的豆包原生格式，不要将该请求直接发到统一 /v1/videos。

创建响应

{
  "id": "task_doubao_example"
}

响应 id 是青云任务 ID，不必具有上游 cgt-… 前缀。保存原值并按查询、下载与错误处理继续。