vidu-video

# Vidu Q3 视频生成

Vidu 最新 Q3 Pro 文生视频模型，支持多种分辨率（360p~1080p），可自定义时长和宽高比，支持直接生成带音频的视频。

## 可用模型

| 模型 ID | 功能 | 说明 |
|--------|------|------|
| `fal-ai/vidu/q3/text-to-video` | 文生视频 | 从文字描述生成视频，支持带音频输出 |

## 定价

按 **视频秒数 × 分辨率** 计费：

| 分辨率 | 价格（积分/秒） | 5秒视频 | 10秒视频 |
|--------|---------------|---------|---------|
| 360p / 540p | 28 积分/秒 | 140 积分 | 280 积分 |
| 720p / 1080p | 62 积分/秒 | 310 积分 | 620 积分 |

## 工作流

### 1. 调用 submit_task

使用 MCP 工具 `submit_task` 提交任务：

```json
{
  "model_id": "fal-ai/vidu/q3/text-to-video",
  "parameters": {
    "prompt": "In an ultra-realistic fashion photography style featuring light blue and pale amber tones, an astronaut in a spacesuit walks through the fog.",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "audio": true
  }
}
```

### 参数说明

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|-----|------|-----|-------|------|
| prompt | string | **是** | - | 视频生成提示词（最大 2000 字符） |
| duration | integer | 否 | 5 | 视频时长（秒），1-16 |
| resolution | string | 否 | "720p" | 分辨率：360p / 540p / 720p / 1080p |
| aspect_ratio | string | 否 | "16:9" | 宽高比：16:9 / 9:16 / 4:3 / 3:4 / 1:1 |
| audio | boolean | 否 | true | 是否生成带音频的视频 |
| seed | integer | 否 | - | 随机种子，用于复现结果 |

## 查询任务状态

提交任务后会返回 `task_id`，使用 `get_task` 查询结果：

```json
{
  "task_id": "返回的任务ID"
}
```

任务状态：
- `pending` - 排队中
- `processing` - 处理中
- `completed` - 完成，结果在 `result` 中
- `failed` - 失败，查看 `error` 字段

## 完整示例

**用户请求**：生成一段宇航员在雾中行走的视频

**执行步骤**：

1. 调用 `submit_task`：
```json
{
  "model_id": "fal-ai/vidu/q3/text-to-video",
  "parameters": {
    "prompt": "In an ultra-realistic fashion photography style featuring light blue and pale amber tones, an astronaut in a spacesuit walks through the fog.",
    "d...