# Gemini Omni 1.2 Flash API

Google Gemini Omni 1.2 Flash 视频生成模型的完整 API 参考文档。

## 模型变体

此 API 支持以下四种模型变体：

| 模型 | ID | 说明 |
|-------|-----|-------------|
| **Gemini Omni 1.2 Flash Text to Video** | `gemini-omni-1.2-flash-text-to-video` | 根据文本提示词生成视频 |
| **Gemini Omni 1.2 Flash Image to Video** | `gemini-omni-1.2-flash-image-to-video` | 将必填的首帧图像转换为视频，可提供尾帧图像来引导画面变化 |
| **Gemini Omni 1.2 Flash Video Edit** | `gemini-omni-1.2-flash-video-edit` | 根据提示词编辑现有视频 |
| **Gemini Omni 1.2 Flash Reference to Video** | `gemini-omni-1.2-flash-reference-to-video` | 根据参考图像、参考视频或两者的组合生成视频 |

## 模型对比

| 特性 | 文生视频 | 图生视频 | 视频编辑 | 参考素材生成视频 |
|---------|---------------|----------------|------------|--------------------|
| 主要输入 | 文本提示词 | 首帧图像和文本提示词 | 源视频和文本提示词 | 文本提示词，以及至少一张参考图像或一段参考视频 |
| 时长 | 3 至 15 秒 | 3 至 15 秒，提供尾帧时为 3 至 10 秒 | 源视频不得超过 10 秒 | 3 至 15 秒 |
| 可选分辨率 | 360p, 720p, 1080p, 4k | 360p, 720p, 1080p, 4k | 360p, 720p, 1080p, 4k | 360p, 720p, 1080p, 4k |
| 宽高比 | 16:9、9:16 | 16:9、9:16 | 不支持 | 16:9、9:16 |
| 可选输入 | 无 | 尾帧图像 | 无 | 最多 10 张图像和 3 段视频，至少提供一份参考素材 |

## 共用端点

所有 Gemini Omni 1.2 Flash 变体都使用以下视频任务端点：

```
POST /api/v1/video/task
```

## Gemini Omni 1.2 Flash Text to Video

### 必填参数

| 参数 | 类型 | 说明 |
|-----------|------|-------------|
| `model_name` | string | 必须为 `"gemini-omni-1.2-flash-text-to-video"` |
| `prompt` | string | 用文字描述要生成的视频 |
| `aspect_ratio` | string | 输出宽高比，可选 `"16:9"` 或 `"9:16"` |
| `resolution` | string | 输出分辨率，可选 `"360p"`、`"720p"`、`"1080p"` 或 `"4k"` |
| `duration` | integer | 输出视频的时长，范围为 3 至 15 秒 |

### 请求示例

```javascript
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'gemini-omni-1.2-flash-text-to-video',
    prompt: 'A cinematic tracking shot follows a sailboat crossing a glowing ocean at sunset',
    aspect_ratio: '16:9',
    resolution: '1080p',
    duration: 12
  })
});

const { data } = await response.json();
const taskId = data.task_id;
```

## Gemini Omni 1.2 Flash Image to Video

### 必填参数

| 参数 | 类型 | 说明 |
|-----------|------|-------------|
| `model_name` | string | 必须为 `"gemini-omni-1.2-flash-image-to-video"` |
| `prompt` | string | 用文字描述期望的运动效果和场景变化 |
| `image_url` | string | 首帧图像的 URL，必填 |
| `aspect_ratio` | string | 输出宽高比，可选 `"16:9"` 或 `"9:16"` |
| `resolution` | string | 输出分辨率，可选 `"360p"`、`"720p"`、`"1080p"` 或 `"4k"` |
| `duration` | integer | 输出视频的时长。未指定尾帧时为 3 至 15 秒，提供 `image_end_url` 时为 3 至 10 秒 |

### 可选参数

| 参数 | 类型 | 说明 |
|-----------|------|-------------|
| `image_end_url` | string | 可选的尾帧图像 URL。提供此参数时，`duration` 必须在 3 至 10 秒之间 |

### 请求示例

```javascript
{
  model_name: 'gemini-omni-1.2-flash-image-to-video',
  prompt: 'The girl walks toward the camera while the city lights shimmer behind her',
  image_url: 'https://example.com/start-frame.jpg',
  image_end_url: 'https://example.com/end-frame.jpg',
  aspect_ratio: '9:16',
  resolution: '1080p',
  duration: 8
}
```

## Gemini Omni 1.2 Flash Video Edit

### 必填参数

| 参数 | 类型 | 说明 |
|-----------|------|-------------|
| `model_name` | string | 必须为 `"gemini-omni-1.2-flash-video-edit"` |
| `prompt` | string | 用文字说明要对视频做哪些修改 |
| `video_url` | string | 源视频的 URL。源视频时长不得超过 10 秒 |
| `resolution` | string | 输出分辨率，可选 `"360p"`、`"720p"`、`"1080p"` 或 `"4k"` |

**注意：** 视频编辑不支持 `aspect_ratio` 和 `duration`。请求中请勿包含这两个参数。

### 请求示例

```javascript
{
  model_name: 'gemini-omni-1.2-flash-video-edit',
  prompt: 'A small ball rolls into the scene and captures the attention of the cat',
  video_url: 'https://example.com/source-video.mp4',
  resolution: '1080p'
}
```

## Gemini Omni 1.2 Flash Reference to Video

参考图像和参考视频可以单独使用，也可以组合使用。必须通过 `images` 或 `videos` 提供至少一张参考图像或一段参考视频。

### 必填参数

| 参数 | 类型 | 说明 |
|-----------|------|-------------|
| `model_name` | string | 必须为 `"gemini-omni-1.2-flash-reference-to-video"` |
| `prompt` | string | 用文字描述要生成的视频 |
| `aspect_ratio` | string | 输出宽高比，可选 `"16:9"` 或 `"9:16"` |
| `resolution` | string | 输出分辨率，可选 `"360p"`、`"720p"`、`"1080p"` 或 `"4k"` |
| `duration` | integer | 输出视频的时长，范围为 3 至 15 秒 |

### 可选参考素材

| 参数 | 类型 | 说明 |
|-----------|------|-------------|
| `images` | string[] | 最多可提供 10 个参考图像 URL。已提供参考视频时可省略 |
| `videos` | string[] | 最多可提供 3 个参考视频 URL，每段视频不得超过 3 秒。已提供参考图像时可省略 |

### 请求示例

```javascript
{
  model_name: 'gemini-omni-1.2-flash-reference-to-video',
  prompt: 'Use the references to create a cinematic shot of a small boat approaching from the distance',
  aspect_ratio: '16:9',
  resolution: '1080p',
  duration: 12,
  images: ['https://example.com/boat-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4']
}
```

## 响应格式

### 初始响应

所有模型均返回一个用于轮询的 `task_id`：

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}
```

### 轮询响应

轮询 `GET /api/v1/video/{taskId}` 即可查询任务状态：

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "credit": 0.2,
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}
```

### 状态值

- `submitted`：任务已受理，等待处理
- `processing`：正在生成视频
- `succeed`：视频生成完成
- `failed`：视频生成失败

## 最佳实践

1. **提示词写法**：清楚描述主体、动作、镜头运动、光照以及场景如何发展。
2. **必填设置**：始终指定模型支持的分辨率。除视频编辑外，还须指定模型支持的宽高比和时长。
3. **图像输入**：为首帧、尾帧和参考图像提供稳定且可公开访问的 URL。提供尾帧图像时，将 `duration` 设为 3 至 10 秒。
4. **视频编辑输入**：提交前确认源视频的时长不超过 10 秒。
5. **参考素材限制**：至少提供一张参考图像或一段参考视频。最多可提交 10 张图像和 3 段视频，每段参考视频不得超过 3 秒。