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

# 国产视频模型概览

> 汇总国产视频模型系列的接入方式、模型命名、参数规范与查询流程。

# 国产视频模型

国产视频模型提供统一的 OpenAI 兼容接口,支持文生视频、图生视频、首尾帧生视频、动作控制、数字人、对口型等多种生成模式。

## 快速开始

<CardGroup cols={2}>
  <Card title="视频生成" icon="clapperboard" href="/zh/videos/aigc/generation">
    `POST /v1/videos`,提交国产视频任务,支持多种生成场景。
  </Card>

  <Card title="任务查询" icon="hourglass" href="/zh/videos/aigc/query">
    `GET /v1/videos/{task_id}`,查询任务状态与结果。
  </Card>
</CardGroup>

## 模型家族

### 热门模型

| 模型系列      | 代表模型               | 特色能力              |
| --------- | ------------------ | ----------------- |
| **即梦**    | `jimeng-video-3.0` | 文生、图生、首尾帧生视频      |
| **Vidu**  | `viduq3-pro`       | 音视频直出、背景音乐、错峰模式   |
| **Kling** | `Kling-3.0-Omni`   | 动作控制、数字人、对口型、模板特效 |

### 完整模型列表

**基础模型：**

* `Vidu-*`、`Kling-*`、`GV-*`、`OS-*`
* `Hunyuan-*`、`Mingmou-*`、`Hailuo-*`
* `SV-*`、`JV-*`、`jimeng-video-*`

**组合计费模型：**

* `vidu-q2-pro-reference-1080p-offpeak`
* `kling-3.0-omni-1080p-ref-audio`
* `kling-2.6-motion-pro-1080p`
* `kling-avatar-720p`
* `sv-1.5-pro-1080p-audio`

## 接入方式

国产视频模型统一使用以下接口：

| 操作       | 接口                                 | 说明        |
| -------- | ---------------------------------- | --------- |
| **创建任务** | `POST /v1/videos`                  | 提交视频生成任务  |
| **查询状态** | `GET /v1/videos/{task_id}`         | 查询任务进度与状态 |
| **获取内容** | `GET /v1/videos/{task_id}/content` | 获取视频下载地址  |

> **注意**：不同模型系列可能提供多套接入方式。
>
> * **Vidu**：官方格式 (`/vidu/ent/v2/*`)、OpenAI 格式 (`/v1/videos`)、统一视频 (`/v1/video/create`)
> * **即梦**：OpenAI 格式 (`/v1/videos`)、统一视频 (`/v1/video/create`)、豆包渠道
> * **Kling**：OpenAI 格式 (`/v1/videos`)
>
> 本页面主要介绍 OpenAI 兼容接口的通用规范，各模型特有接口请参阅下方[模型文档](#模型文档)。

## 请求参数

### 图片输入说明

不同接入方式使用不同的图片字段：

| 接入方式                  | 字段名               | 格式     | 说明        |
| --------------------- | ----------------- | ------ | --------- |
| OpenAI 格式 (multipart) | `input_reference` | file   | 文件上传      |
| OpenAI 格式 (JSON)      | `image`           | string | 图片 URL    |
| 统一视频                  | `images`          | array  | 图片 URL 数组 |

### 基础字段

| 字段                | 类型     | 必填 | 说明                    |
| ----------------- | ------ | -- | --------------------- |
| `model`           | string | ✅  | 模型名称,支持基础模型或组合计费模型    |
| `prompt`          | string | ✅  | 提示词,生成视频的文本描述         |
| `seconds`         | string | ❌  | 视频时长,例如 `5`、`10`、`15` |
| `size`            | string | ❌  | 快速尺寸输入,例如 `720x1280`  |
| `image`           | string | ❌  | 参考图片 URL(图生视频场景)      |
| `images`          | array  | ❌  | 参考图片数组(首尾帧场景)         |
| `input_reference` | file   | ❌  | 参考文件(OpenAI 格式上传)     |
| `metadata`        | object | ❌  | 扩展参数,建议放上游原生配置        |

### metadata 扩展参数

**场景类型：**

| 场景    | 值                 | 说明       |
| ----- | ----------------- | -------- |
| 动作控制  | `motion_control`  | 精确控制视频动作 |
| 数字人生成 | `avatar_i2v`      | 生成数字人视频  |
| 对口型   | `lip_sync`        | 音画同步对口型  |
| 模板特效  | `template_effect` | 应用模板特效   |

**输出配置 (metadata.output\_config)：**

| 字段                 | 类型      | 说明                        |
| ------------------ | ------- | ------------------------- |
| `resolution`       | string  | 分辨率:`720P`、`1080P`        |
| `aspect_ratio`     | string  | 画幅比例:`16:9`、`9:16`、`1:1`  |
| `duration`         | integer | 时长(秒)                     |
| `audio_generation` | string  | 音频生成:`Enabled`、`Disabled` |

**其他常用字段：**

* `motion_level`：运动等级(`std`/`pro`)
* `offpeak`：是否错峰计费
* `last_frame_url`：首尾帧中的尾帧
* `video_url`：参考视频 URL
* `file_infos`：原生 FileInfos 透传
* `ext_info`：原生 ExtInfo 字符串透传

## 参数优先级

### 时长参数

1. 顶层 `seconds`
2. 顶层 `duration`
3. `metadata.seconds` / `metadata.duration` / `metadata.video_duration`
4. 默认 `5`

### 分辨率参数

1. `metadata.output_config.resolution`
2. 顶层 `size`
3. 模型默认值

## 场景示例

### 文生视频

```json theme={null}
{
  "model": "Kling-3.0-Omni",
  "prompt": "赛博朋克城市夜景,镜头慢慢推进",
  "seconds": "5",
  "metadata": {
    "output_config": {
      "resolution": "720P",
      "aspect_ratio": "16:9"
    }
  }
}
```

### 图生视频

```json theme={null}
{
  "model": "viduq3-pro",
  "prompt": "让人物向前走并微笑",
  "image": "https://example.com/character.png",
  "seconds": "5",
  "metadata": {
    "output_config": {
      "resolution": "1080P",
      "aspect_ratio": "9:16"
    }
  }
}
```

### 首尾帧生视频

```json theme={null}
{
  "model": "Kling-3.0-Omni",
  "prompt": "死寂系统空间中,角色被蓝色面板照亮",
  "seconds": "15",
  "size": "720x1280",
  "metadata": {
    "output_config": {
      "duration": 15,
      "resolution": "720P",
      "aspect_ratio": "9:16",
      "audio_generation": "Enabled"
    },
    "last_frame_url": "https://example.com/last-frame.png"
  }
}
```

### 动作控制

```json theme={null}
{
  "model": "Kling-3.0-Omni",
  "prompt": "人物挥手打招呼",
  "image": "https://example.com/character.png",
  "seconds": "5",
  "metadata": {
    "scene_type": "motion_control",
    "motion_level": "pro",
    "output_config": {
      "resolution": "1080P",
      "aspect_ratio": "16:9"
    }
  }
}
```

## 模型文档

目前优先提供以下主流模型的详细文档：

<CardGroup cols={3}>
  <Card title="即梦视频" icon="sparkles" href="/zh/videos/jimeng/overview">
    `jimeng-video-3.0`、`jimeng-video-2.0` 的生成与查询文档。
  </Card>

  <Card title="Vidu 视频" icon="clapperboard" href="/zh/videos/vidu/overview">
    `viduq3-pro`、`viduq2`、`viduq1` 系列的三套接入方式。
  </Card>

  <Card title="Kling 视频" icon="film" href="/zh/videos/kling/overview">
    `Kling-3.0-Omni`、`Kling-2.6`、`Kling-2.5` 的多种生成模式。
  </Card>
</CardGroup>

<Info>
  其他模型（`GV-*`、`OS-*`、`Hunyuan-*`、`Mingmou-*`、`Hailuo-*`、`SV-*`、`JV-*`）的详细文档正在整理中，您可以参考[国产视频模型生成](./generation)了解通用的参数规范和使用方法。
</Info>

## 鉴权

渠道密钥格式：

* `SubAppId|SecretId|SecretKey`
* `SubAppId|SecretId|SecretKey|Region`

## 相关页面

* [视频模型支持矩阵](/zh/videos/model-matrix)
* [即梦视频概览](/zh/videos/jimeng/overview)
* [Vidu 视频概览](/zh/videos/vidu/overview)
* [Kling 视频概览](/zh/videos/kling/overview)
* [国产视频模型生成](./generation)
* [国产视频模型查询](./query)