> ## Documentation Index
> Fetch the complete documentation index at: https://docs.geekai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Doubao-Seedance-1.0-Pro

Seedance 1.0 pro 视频生成模型具备出色的语义理解能力，可根据用户输入的文本、图片等内容，快速生成优质的视频片段。

Seedance 1.0 pro fast 是一款价格触底、效能封顶的全面模型，在视频生成质量、速度、成本之间取得了卓越平衡。它在继承 Seedance 1.0 pro 模型核心优势的基础上，生成速度较 Seedance 1.0 pro 最高提升约 3倍，价格直降72%，为创作者带来效率与成本双重优化的体验。

> [!NOTE]
>
> 调用 API 时请注意，Seedance 1.0 pro fast 仅支持首帧图和文字描述生成视频，不支持多参考图和首尾帧生成视频，其他参数与 Seedance 1.0 pro 完全一致。

### 模型参数

* 模型ID：`doubao-seedance-1.0-pro`/`doubao-seedance-1.0-pro-fast`
* 模型价格：你可以在[模型广场](https://geekai.co/models?platform=bytedance\&type=video)查看最新价格信息
* 调用入口：`https://geekai.co/api/v1/videos/generations`
* 模型参数：参考[视频 API 手册](https://docs.geekai.co/cn/api/video/generations.md)
* API认证：[获取 API KEY](https://docs.geekai.co/cn/docs/quick_start.md)

> [!NOTE]
>
> 不支持视频 API 中的以下参数：
>
> * `negative_prompt`
> * `with_audio`
> * `size`
> * `quality`
>
> 附：[Seedance 1.0 Pro 官方 API 文档](https://www.volcengine.com/docs/82379/1366799)

Doubao-Seedance-1.0 Pro 官方 API 参数与极客智坊视频 API 参数差异较大，下面是如何通过极客智坊视频 API 调用 Doubao-Seedance-1.0 Pro 的说明：

通过视频 API 的 `prompt` + `image` + `image_tail` 传值，极客智坊会自动将其组装为 `doubao-seedance-1.0-pro` 的 `content` 参数：

* `prompt`：文本描述
* `image`：如果是字符串则作为首帧参考图传入，如果是数组则作为多张参考图传入（使用参考图时不要设置 `image_tail`，目前仅 `doubao-seedance-1.0-lite-i2v` 模型支持参考图）
* `image_tail`：尾帧参考图（`doubao-seedance-1.0-pro-fast` 不支持该参数）

所有图片均支持传入图片 URL 或者 Base64 编码的图片数据。

对于其他模型参数，你可以按照官方 API 文档中介绍的那样通过在文本提示词后追加 `--[parameters]` ，控制视频输出的规格，包括宽高比、帧率、分辨率等：

```markdown theme={null}
小猫对着镜头打哈欠。 --rs 720p --rt 16:9 --dur 5 --fps 24 --wm true --seed 11 --cf false
```

也可以通过极客智坊视频 API 参数显式传递，极客智坊底层调用时会自动将其追加到文本提示词 prompt 后面作为文本指令：

* `resolution`：分辨率，支持 `480p`、`720p`（默认值）、`1080p`
* `aspect_ratio`：宽高比，支持 `1:1`、`3:4`、`4:3`、`16:9`、`9:16`、 `21:9`、`keep_ratio`（与参考图保持一致）、 `adaptive`（自动选择合适的宽高比，默认值）
* `duration`：生成视频时长，单位：秒，支持 `3~12` 秒，默认 `5` 秒
* `fps`：帧率，支持 `16`、`24`，默认 `24`
* `camerafixed`：是否固定摄像机位置，支持 `true`、`false`（默认值）
* `watermark`：是否添加水印，支持 `true`、`false`（默认值）
* `seed`：随机种子，取值范围 `[-1, 2^32-1]`，默认值是 `-1`

### 文生视频

通过文字描述来生成对应视频：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model":"doubao-seedance-1.0-pro",
    "prompt":"小猫对着镜头打哈欠。 --rs 720p --rt 16:9 --dur 5 --fps 24 --wm true --seed 11 --cf false"
}'
```

响应是一个 JSON 对象，包含生成视频的 URL：

```json theme={null}
{
    "model": "doubao-seedance-1.0-pro",
    "task_id": "7ea610cc-5f50-4ab7-a0ad-9894032ef92a",
    "task_status": "succeed",
    "video_result": [
        {
            "url": "https://static.geekai.co/video/2025/10/14/6340d3eb8ac3c0d9f21ae6dacba72327.mp4",
            "duration": 5.042
        }
    ]
}
```

下面图生视频生成响应结构是一样的，不再列举。

### 图生视频

**首帧**

通过 `image` 传入单图即可实现基于首帧生成视频：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model":"doubao-seedance-1.0-pro-fast",
    "prompt":"女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动 --wm true --dur 5",
    "image":"https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
}'
```

> [!NOTE]
>
> `doubao-seedance-1.0-pro`、`doubao-seedance-1.0-pro-fast`、`doubao-seedance-1.0-lite-i2v` 等支持图生视频的模型均支持该功能。

**首尾帧**

通过 `image` + `image_tail` 传入首尾两张图即可实现基于首尾帧生成视频：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model":"doubao-seedance-1.0-pro",
    "prompt":"360度环绕运镜",
    "image":"https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg",
    "image_tail":"https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg"
}'
```

> [!NOTE]
>
> `doubao-seedance-1.0-pro-fast` 模型不支持该功能。

**参考图**

通过 `image` 传入多张图即可实现基于多张参考图生成视频：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model":"doubao-seedance-1.0-lite-i2v",
    "prompt":"[图1]戴着眼镜穿着蓝色T恤的男生和[图2]的柯基小狗，坐在[图3]的草坪上，3D卡通风格",
    "image":[
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_1.png",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_2.png",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_3.png"
    ]
}'
```

> [!NOTE]
>
> 仅 `doubao-seedance-1.0-lite-i2v` 模型支持该功能。

### 异步任务

由于视频生成通常比较耗时，建议通过极客智坊提供的通用异步方式生成视频。

[视频 API](https://docs.geekai.co/cn/api/video/generations.md) 中的 `async` 参数用于控制是否异步生成视频，默认为 `false`，表示创建视频接口会同步等待视频生成完毕并返回。如果设置为 `true`，则会异步生成视频并返回任务ID，你可以使用该任务ID轮询视频生成状态。

具体操作请参考[Sora-2示例](https://docs.geekai.co/cn/docs/video/openai/sora-2#异步任务)，流程完全一样。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.