> ## Documentation Index
> Fetch the complete documentation index at: https://api-doc.vncps.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 豆包视频生成 API

> 使用 doubao-seedance 模型生成高质量视频

## 模型对比

| 模型                                    | 分辨率支持           | 文生视频 | 图生视频-首帧 | 图生视频-首尾帧 | 有声视频 |
| ------------------------------------- | --------------- | ---- | ------- | -------- | ---- |
| `doubao-seedance-1-0-pro-250528`      | 480p/720p/1080p | ✅    | ✅       | ✅        | ❌    |
| `doubao-seedance-1-0-pro-fast-251015` | 480p/720p/1080p | ✅    | ✅       | ❌        | ❌    |
| `doubao-seedance-1-5-pro-251215`      | 480p/720p/1080p | ✅    | ✅       | ✅        | ✅    |

## 文生视频

通过文本描述生成视频。

<Note>
  **配置说明：**

  * 将 `api.xxx.com` 替换为您的实际 API 域名
  * 将 `sk-xxx` 替换为您的 API 密钥（可在控制台获取）
</Note>

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.xxx.com/v1/video/generations \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer sk-xxx" \
     -d '{
       "model": "doubao-seedance-1-0-pro-fast-251015",
       "prompt": "多个镜头。一名侦探进入一间光线昏暗的房间。他检查桌上的线索,手里拿起桌上的某个物品。镜头转向他正在思索。",
       "resolution": "480p",
       "ratio": "16:9",
       "duration": 10,
       "fps": 24,
       "watermark": true,
       "seed": 11,
       "camerafixed": false
     }'
  ```

  ```json Response theme={null}
  {
    "task_id": "cgt-20251209112555-fdqtx"
  }
  ```
</CodeGroup>

<Note>
  视频生成为异步任务，您需要使用返回的 `task_id` 来查询生成结果。
</Note>

## 参数说明

### 基础参数（必填）

| 参数名          | 类型      | 说明      | 可选值                                                                                                         |
| ------------ | ------- | ------- | ----------------------------------------------------------------------------------------------------------- |
| `model`      | string  | 模型名称    | `doubao-seedance-1-0-pro-fast-251015` / `doubao-seedance-1-0-pro-250528` / `doubao-seedance-1-5-pro-251215` |
| `prompt`     | string  | 文本提示词   | 中英文描述，建议≤500字                                                                                               |
| `resolution` | string  | 视频分辨率   | `480p` / `720p` / `1080p`<br />默认：`1080p`                                                                   |
| `ratio`      | string  | 视频宽高比   | `16:9` / `4:3` / `1:1` / `3:4` / `9:16` / `21:9` / `adaptive`                                               |
| `duration`   | integer | 视频时长（秒） | 2\~12秒                                                                                                      |

### 可选参数

| 参数名                 | 类型      | 默认值   | 说明                                           | 适用场景                                                                    |
| ------------------- | ------- | ----- | -------------------------------------------- | ----------------------------------------------------------------------- |
| `images`            | array   | -     | 图片URL数组<br />• 单张图片 = 首帧<br />• 两张图片 = 首尾帧   | 首尾帧支持：`doubao-seedance-1-0-pro-250528`、`doubao-seedance-1-5-pro-251215` |
| `fps`               | integer | -     | 视频帧率                                         | `24`                                                                    |
| `seed`              | integer | -1    | 随机种子<br />• -1 表示随机<br />• 取值范围：\[-1, 2³²-1] | 全部模型                                                                    |
| `watermark`         | boolean | false | 是否添加水印                                       | `true` / `false`                                                        |
| `camerafixed`       | boolean | false | 相机固定<br />固定镜头，减少运镜幅度                        | `true` / `false`                                                        |
| `generate_audio`    | boolean | false | 是否生成音频<br />生成带声音的视频                         | 仅 `doubao-seedance-1-5-pro-251215` 支持                                   |
| `draft`             | boolean | false | 样片生成模式<br />快速生成低分辨率预览                       | 仅 `doubao-seedance-1-5-pro-251215` 支持<br />仅支持 `480p`                   |
| `draft_task_id`     | string  | -     | 样片任务ID<br />基于样片生成高质量成片                      | 使用样片生成成片时必填                                                             |
| `service_tier`      | string  | -     | 服务层级<br />• `flex` = 离线推理模式                  | 全部模型                                                                    |
| `return_last_frame` | boolean | false | 返回视频尾帧图像<br />**(暂不支持)**                     | `true` / `false`                                                        |

## 图生视频-首帧

基于首帧图片生成视频。

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.xxx.com/v1/video/generations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer sk-xxx" \
    -d '{
      "model": "doubao-seedance-1-0-pro-fast-251015",
      "prompt": "女孩抱着狐狸,女孩睁开眼,温柔地看向镜头",
      "images": ["https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"],
      "resolution": "480p",
      "ratio": "adaptive",
      "duration": 10,
      "fps": 24,
      "watermark": true,
      "seed": 11,
      "camerafixed": false
    }'
  ```

  ```json Response theme={null}
  {
    "task_id": "cgt-20251209112555-fdqtx"
  }
  ```
</CodeGroup>

## 图生视频-首尾帧

基于首尾两帧图片生成视频（仅 `doubao-seedance-1-0-pro-250528` 支持）。

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.xxx.com/v1/video/generations \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer sk-xxx" \
    -d '{
      "model": "doubao-seedance-1-0-pro-250528",
      "prompt": "360度环绕运镜",
      "images": [
          "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg",
          "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg"
      ],
      "resolution": "480p",
      "ratio": "adaptive",
      "duration": 10,
      "fps": 24,
      "watermark": true,
      "seed": 11,
      "camerafixed": false
  }'
  ```

  ```json Response theme={null}
  {
    "task_id": "cgt-20251209112555-fdqtx"
  }
  ```
</CodeGroup>

## 查询视频任务

使用任务ID查询视频生成结果。

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.xxx.com/v1/video/generations/{task_id} \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer sk-xxx"
  ```

  ```json Response theme={null}
  {
      "code": "success",
      "message": "",
      "data": {
          "task_id": "cgt-20251209173715-6mn48",
          "action": "generate",
          "status": "SUCCESS",
          "fail_reason": "",
          "submit_time": 1765273035,
          "start_time": 1765273037,
          "finish_time": 1765273082,
          "progress": "100%",
          "data": {
              "id": "cgt-20251209173715-6mn48",
              "seed": 11,
              "model": "doubao-seedance-1-0-pro-fast-251015",
              "ratio": "16:9",
              "usage": {
                  "total_tokens": 97605,
                  "completion_tokens": 97605
              },
              "status": "succeeded",
              "content": {
                  "video_url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/..."
              },
              "duration": 10,
              "created_at": 1765273035,
              "resolution": "480p",
              "updated_at": 1765273077,
              "service_tier": "default",
              "framespersecond": 24,
              "execution_expires_after": 172800
          }
      }
  }
  ```
</CodeGroup>

### 任务状态说明

| 状态           | 说明     |
| ------------ | ------ |
| `PENDING`    | 任务排队中  |
| `PROCESSING` | 任务处理中  |
| `SUCCESS`    | 任务成功完成 |
| `FAILED`     | 任务失败   |

## 有声视频生成

使用 `doubao-seedance-1-5-pro-251215` 模型生成带音频的视频。

### 有声视频-图生视频

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.xxx.com/v1/video/generations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer sk-xxx" \
    -d '{
      "model": "doubao-seedance-1-5-pro-251215",
      "prompt": "女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动，可以听到风声",
      "images": ["https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"],
      "resolution": "480p",
      "ratio": "adaptive",
      "duration": 5,
      "fps": 24,
      "watermark": false,
      "generate_audio": true
    }'
  ```

  ```json Response theme={null}
  {
    "task_id": "cgt-20251209112555-fdqtx"
  }
  ```
</CodeGroup>

### 有声视频-首尾帧

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.xxx.com/v1/video/generations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer sk-xxx" \
    -d '{
      "model": "doubao-seedance-1-5-pro-251215",
      "prompt": "图中女孩对着镜头说茄子，360度环绕运镜",
      "images": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg"
      ],
      "resolution": "480p",
      "ratio": "adaptive",
      "duration": 5,
      "fps": 24,
      "watermark": false,
      "generate_audio": true
    }'
  ```

  ```json Response theme={null}
  {
    "task_id": "cgt-20251209112555-fdqtx"
  }
  ```
</CodeGroup>

### 有声视频-文生视频

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.xxx.com/v1/video/generations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer sk-xxx" \
    -d '{
      "model": "doubao-seedance-1-5-pro-251215",
      "prompt": "无人机以极快速度穿越复杂障碍或自然奇观，带来沉浸式飞行体验",
      "resolution": "480p",
      "ratio": "16:9",
      "duration": 5,
      "fps": 24,
      "watermark": true,
      "camerafixed": false,
      "generate_audio": true
    }'
  ```

  ```json Response theme={null}
  {
    "task_id": "cgt-20251209112555-fdqtx"
  }
  ```
</CodeGroup>

<Note>
  使用 `generate_audio: true` 参数可生成带环境音效的视频，模型会根据提示词和画面内容自动生成匹配的音频轨道。
</Note>

## 样片生成 (Draft Mode)

使用样片模式快速预览视频效果，确认后再生成高清成片。

### 生成样片

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.xxx.com/v1/video/generations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer sk-xxx" \
    -d '{
      "model": "doubao-seedance-1-5-pro-251215",
      "prompt": "延时摄影，因固定镜头，薄雾升腾汇聚成云海，云海沿山势流动，阳光照射使云海泛金光，云层边缘逐渐清晰",
      "resolution": "480p",
      "ratio": "16:9",
      "duration": 5,
      "fps": 24,
      "watermark": false,
      "camerafixed": false,
      "draft": true,
      "generate_audio": true
    }'
  ```

  ```json Response theme={null}
  {
    "task_id": "cgt-20260121161956-vbk57"
  }
  ```
</CodeGroup>

<Note>
  * 样片模式仅支持 `480p` 分辨率
  * 生成速度更快，成本更低
  * 适合内容预览和效果确认
</Note>

### 基于样片生成成片

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.xxx.com/v1/video/generations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer sk-xxx" \
    -d '{
      "model": "doubao-seedance-1-5-pro-251215",
      "prompt": "延时摄影，因固定镜头，薄雾升腾汇聚成云海，云海沿山势流动，阳光照射使云海泛金光，云层边缘逐渐清晰",
      "resolution": "720p",
      "ratio": "16:9",
      "duration": 5,
      "draft_task_id": "cgt-20260121161956-vbk57"
    }'
  ```

  ```json Response theme={null}
  {
    "task_id": "cgt-20260121162156-abc12"
  }
  ```
</CodeGroup>

<Note>
  * 使用样片任务ID生成高清成片
  * 支持 `720p` / `1080p` 分辨率
  * 继承样片的内容和风格，提高生成成功率
</Note>

## 离线推理 (Flex Tier)

适合批量处理场景的异步推理模式。

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.xxx.com/v1/video/generations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer sk-xxx" \
    -d '{
      "model": "doubao-seedance-1-5-pro-251215",
      "prompt": "延时摄影，因固定镜头，薄雾升腾汇聚成云海，云海沿山势流动，阳光照射使云海泛金光，云层边缘逐渐清晰",
      "resolution": "720p",
      "ratio": "16:9",
      "duration": 5,
      "fps": 24,
      "watermark": false,
      "camerafixed": false,
      "service_tier": "flex",
      "generate_audio": true
    }'
  ```

  ```json Response theme={null}
  {
    "task_id": "cgt-batch-20260121162256-xyz89"
  }
  ```
</CodeGroup>

<Note>
  * 任务ID格式为 `cgt-batch-*`
  * 成本更低，适合大批量生成
  * 处理时间可能较长，需要等待几分钟到几小时，不等适合非紧急任务
</Note>

<Warning>
  视频生成任务的执行时间取决于队列长度和视频时长，通常需要几分钟时间。
</Warning>