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

# Doubao-Seedance 2.5 — 图生视频

> 使用 Doubao-Seedance 2.5 将首帧图片以 720p 或 1080p 生成 4–30 秒、带原生音频的视频。

|           |                               |
| --------- | ----------------------------- |
| **模型 ID** | `bytedance/seedance-2-5-i2v`  |
| **系列**    | `seedance-2-5`                |
| **任务**    | `image-to-video`              |
| **模态**    | 视频                            |
| **上游**    | ByteDance Doubao-Seedance 2.5 |

## Endpoint

```http theme={null}
POST https://vibetoken.cn/v1/videos/generations
```

异步调用：返回 `{id, status: "pending"}`；轮询
`GET /v1/videos/generations/{id}`，直到状态为 `success` 或 `failed`。

## 参数

<ParamField body="prompt" type="string" required>
  文本提示词，描述首帧图片应如何动起来。最多 5000 个字符。
</ParamField>

<ParamField body="image_urls" type="string[]" required>
  单元素数组，内含首帧图片 URL（公网 HTTPS）。
  `min_items: 1, max_items: 1`。
</ParamField>

<ParamField body="resolution" type="&#x22;720p&#x22; | &#x22;1080p&#x22;" default="&#x22;720p&#x22;">
  此处没有 480p：上游对图生视频拒绝该值。[文生视频](/bytedance-seedance-2-5-api/text-to-video)有 480p 档位。
  输出分辨率。每档各有独立的每秒费率。1080p 输出为 10-bit H.265（HEVC）编码，
  少数老旧播放器无法打开。
</ParamField>

<ParamField body="ratio" type="&#x22;adaptive&#x22;" default="&#x22;adaptive&#x22;">
  仅接受 `adaptive`：输出视频沿用首帧图片的宽高比。需要什么画幅，发送前先把图片裁好。
</ParamField>

<ParamField body="duration" type="integer" default="5">
  生成片段的时长（秒），范围 `[4, 30]`。费用随时长变化。
</ParamField>

<ParamField body="generate_audio" type="boolean" default="true">
  生成与画面同步的原生音轨。设为 `false` 可得到无声片段。
</ParamField>

<ParamField body="watermark" type="boolean" default="false">
  在右下角打上 AI 生成水印。
</ParamField>

<ParamField body="output_format" type="&#x22;mp4&#x22; | &#x22;mov&#x22;" default="&#x22;mp4&#x22;">
  封装格式。`mov` 是面向后期制作的高色彩保真格式（H.264 + yuv444p + PCM），
  部分播放器无法打开。
</ParamField>

没有 `seed` 参数：上游不支持，因此每次调用都会生成新的版本。请求中包含 `seed` 会被拒绝。

## 示例

```bash theme={null}
curl https://vibetoken.cn/v1/videos/generations \
  -H "Authorization: Bearer $VIBETOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2-5-i2v",
    "prompt": "the character turns and smiles, camera slowly zooms in",
    "image_urls": ["https://example.com/first-frame.jpg"],
    "resolution": "1080p",
    "duration": 5
  }'
```

```json theme={null}
{ "id": "task_abc123…", "status": "pending", "model": "bytedance/seedance-2-5-i2v" }
```

轮询直到结束：

```bash theme={null}
curl https://vibetoken.cn/v1/videos/generations/task_abc123… \
  -H "Authorization: Bearer $VIBETOKEN_API_KEY"
```

```json theme={null}
{
  "id": "task_abc123…",
  "status": "success",
  "data": [{ "url": "https://…mp4" }]
}
```