> ## 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.

# Vidu Q3 Pro — 首尾帧生视频

> Vidu Q3 Pro 首尾帧生视频，通过统一的 OpenAI 兼容端点。

|           |                        |
| --------- | ---------------------- |
| **模型 ID** | `vidu/q3-pro-f2v`      |
| **家族**    | `vidu-q3-pro-startend` |
| **任务**    | `image-to-video`       |
| **分辨率**   | 540p / 720p / 1080p    |
| **时长**    | 1–16 秒（默认 5）           |
| **模态**    | 视频                     |

## 端点

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

异步 —— 返回 `{id, status: "pending"}`；轮询 `GET /v1/videos/generations/{id}` 直到 `success` 或 `failed`。

## 定价

统一每秒计费，且**含原生音频**，详见[视频生成](/api-reference/videos)。

## 参数

<ParamField body="prompt" type="string" required>
  描述过渡的文本提示词。最多 2000 个字符。
</ParamField>

<ParamField body="image_urls" type="string[]" required>
  恰好两张图像 —— 首帧与尾帧。
</ParamField>

<ParamField body="duration" type="integer" default="5">
  片段时长（秒）。1–16 秒（默认 5）。
</ParamField>

<ParamField body="resolution" type="enum" default="720p">
  输出分辨率。取值为 540p / 720p / 1080p 之一。
</ParamField>

<ParamField body="movement_amplitude" type="enum" default="auto">
  镜头/主体运动。取值为 `auto`、`small`、`medium`、`high` 之一。
</ParamField>

<ParamField body="seed" type="integer">
  随机数生成器的初始化种子。范围 `[0, 2147483647]`。
</ParamField>

## 示例

```bash theme={null}
curl https://vibetoken.cn/v1/videos/generations \
  -H "Authorization: Bearer $VIBETOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "vidu/q3-pro-f2v",
    "image_urls": ["https://example.com/start.jpg", "https://example.com/end.jpg"],
    "prompt": "从首帧到尾帧平滑过渡"
  }'
```

## 参见

完整的请求/响应结构与定价：[视频生成](/api-reference/videos)。