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

# 国产视频模型概览

> 国产视频模型系列的渠道鉴权、模型命名、参数优先级、特殊场景、查询方式与默认价格口径。

# 国产视频模型

国产视频模型指腾讯 VOD AIGC 生视频渠道下的一组模型，统一通过 magic 视频接口调用。

* 提交任务：`POST /v1/videos`
* 查询任务：`GET /v1/videos/{task_id}`
* 获取视频内容：`GET /v1/videos/{task_id}/content`

<CardGroup cols={2}>
  <Card title="视频生成" icon="clapperboard" href="/api-reference/videos/aigc/generation">
    提交国产视频任务，支持文生、图生、参考图、参考视频、首尾帧、动作控制、数字人、对口型和模板特效。
  </Card>

  <Card title="任务查询" icon="hourglass" href="/api-reference/videos/aigc/query">
    查询任务状态、进度、错误与结果地址，并获取生成后的视频内容。
  </Card>
</CardGroup>

## 渠道鉴权

渠道密钥使用竖线分隔：

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

`Region` 可选。创建渠道时选择 AIGC / 腾讯 VOD 相关渠道后，把上面的密钥填入渠道密钥即可。

## 模型命名

用户请求 `model` 推荐传基础模型，例如 `Kling-2.6`、`Vidu-q2-pro`、`GV-3.1-fast`。也可以直接传组合计费模型，例如 `kling-3.0-omni-1080p-ref-audio`、`vidu-q2-pro-reference-1080p-offpeak`。

接口会做两件事：

1. 根据 `model` 识别模型家族和版本，例如 `Kling`、`Vidu`、`GV`、`OS`、`Hailuo`、`Hunyuan`、`Mingmou`、`SV`、`JV`。
2. 根据模型、场景、分辨率、参考输入、音频开关、错峰等参数匹配对应计费规则。

### 基础模型

| 模型名         | 含义        |
| ----------- | --------- |
| `Vidu-*`    | Vidu 系列模型 |
| `Kling-*`   | 可灵系列模型    |
| `GV-*`      | GV 系列模型   |
| `OS-*`      | OS 系列模型   |
| `Hunyuan-*` | 混元系列模型    |
| `Mingmou-*` | 明眸系列模型    |
| `Hailuo-*`  | 海螺系列模型    |
| `SV-*`      | SV 系列模型   |
| `JV-*`      | JV 系列模型   |

### 组合计费模型

组合计费模型可以直接作为 `model` 传入。接口会根据组合模型中的版本、分辨率、场景和音频等信息应用对应参数与计费规则。

| 示例                                    | 含义                                                                 |
| ------------------------------------- | ------------------------------------------------------------------ |
| `vidu-q2-pro-reference-1080p-offpeak` | `vidu` 模型族，`q2-pro` 版本，参考生视频 / 参考模式，`1080p` 分辨率档位，`offpeak` 错峰模式   |
| `kling-3.0-omni-1080p-ref-audio`      | `kling` 模型族，`3.0-omni` 版本，`1080p` 分辨率档位，`ref` 表示有参考输入，`audio` 表示有声 |
| `kling-2.6-motion-pro-1080p`          | `kling` 模型族，`2.6` 版本，动作控制场景，`pro` 动作控制档位，`1080p` 分辨率档位             |
| `kling-avatar-720p`                   | 可灵数字人场景，`720p` 分辨率档位                                               |
| `kling-identify-face`                 | 可灵对口型场景，不足 5 秒按 5 秒计                                               |
| `sv-1.5-pro-1080p-audio`              | `sv` 模型族，`1.5-pro` 版本，`1080p` 分辨率档位，有声                             |

## 国产模型怎么选

| 模型家族                  | 代表模型                                                                                                | 适合场景                         | 选型建议                                   |
| --------------------- | --------------------------------------------------------------------------------------------------- | ---------------------------- | -------------------------------------- |
| `Vidu`                | `Vidu-q2`、`Vidu-q2-pro`、`Vidu-q3-pro`、`Vidu-q3-turbo`、`Vidu-template`                               | 文生视频、图生视频、参考图、多图参考、首尾帧、模板特效  | 更看重参考图、多图输入、模板特效和较完整分辨率档位时，优先看 `Vidu`。 |
| `Kling`               | `Kling-1.6`、`Kling-2.0`、`Kling-2.1`、`Kling-2.5`、`Kling-2.6`、`Kling-3.0`、`Kling-3.0-Omni`、`Kling-O1` | 文生视频、图生视频、动作控制、数字人、对口型、多镜头扩展 | 需要动作控制、数字人、对口型或音频开关时，优先看 `Kling`。      |
| `GV`                  | `GV-3.1`、`GV-3.1-fast`                                                                              | 文生视频、首尾帧、平滑过渡                | 适合固定时长和首尾帧过渡场景。                        |
| `OS`                  | `OS-2.0`                                                                                            | 文生视频                         | 适合参数较少、快速调用的短视频场景。                     |
| `Hunyuan` / `Mingmou` | `Hunyuan-1.5`、`Mingmou-1.0`                                                                         | 常规文生视频                       | 适合通用国产视频接入，参数面相对简单。                    |
| `Hailuo`              | `Hailuo-02`、`Hailuo-2.3`、`Hailuo-2.3-fast`                                                          | 文生视频、首帧生视频                   | 更适合文生和首帧生视频，当前不建议强依赖 `aspect_ratio`。   |
| `SV`                  | `SV-1.5-pro`、`SV-1.0-pro`、`SV-1.0-pro-fast`、`SV-1.0-lite`                                           | 组合计费模型                       | 常见按分辨率和音频开关拆分计费。                       |
| `JV`                  | `JV-3.0-pro`                                                                                        | 组合计费模型                       | 当前多按版本直接计费，参数面较简单。                     |

## 请求体总览

统一请求体使用 `POST /v1/videos`。

| 字段                                     | 说明                                        |
| -------------------------------------- | ----------------------------------------- |
| `model`                                | 模型名称，支持基础模型或组合计费模型                        |
| `prompt`                               | 提示词                                       |
| `seconds` / `duration`                 | 生成时长，顶层字段优先级最高                            |
| `size`                                 | 快速尺寸输入，例如 `720P`、`1080P`、`720x1280`       |
| `image` / `images` / `input_reference` | 图生、参考图、首帧、首尾帧等输入                          |
| `metadata`                             | 扩展参数，建议把高级输出配置放入 `metadata.output_config` |

顶层 `seconds` / `duration` 目前仍然生效，不是只能放进 `metadata`。复杂场景建议显式传 `metadata.output_config.resolution` 和 `metadata.output_config.aspect_ratio`，减少尺寸推断带来的歧义。

## 参数优先级

时长优先级：

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

分辨率优先级：

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

文生 / 图生判定：

* 存在参考输入，例如 `image`、`images`、`input_reference`、`last_frame_*`，按图生或参考输入场景处理。
* 没有参考输入时，按文生视频处理。

## `metadata` 扩展

| 字段                                      | 说明                                                                   |
| --------------------------------------- | -------------------------------------------------------------------- |
| `scene_type`                            | 场景类型，常见值为 `motion_control`、`avatar_i2v`、`lip_sync`、`template_effect` |
| `motion_level`                          | 动作控制档位，`std` / `pro`，用于动作控制计费分档                                      |
| `offpeak`                               | 是否错峰计费，布尔值                                                           |
| `last_frame_url` / `last_frame_file_id` | 首尾帧中的尾帧                                                              |
| `video_url`                             | 参考视频 URL                                                             |
| `file_infos`                            | 素材列表，高级用法                                                            |
| `output_config`                         | 输出配置，支持 snake\_case 字段                                               |
| `ext_info`                              | 扩展信息字符串，高级用法                                                         |

### `output_config` 字段映射

`metadata.output_config` 支持 snake\_case 字段，也兼容对应的 UpperCamelCase 字段：

| snake\_case 字段            | 兼容字段                    |
| ------------------------- | ----------------------- |
| `storage_mode`            | `StorageMode`           |
| `media_name`              | `MediaName`             |
| `class_id`                | `ClassId`               |
| `expire_time`             | `ExpireTime`            |
| `duration`                | `Duration`              |
| `resolution`              | `Resolution`            |
| `aspect_ratio`            | `AspectRatio`           |
| `audio_generation`        | `AudioGeneration`       |
| `person_generation`       | `PersonGeneration`      |
| `input_compliance_check`  | `InputComplianceCheck`  |
| `output_compliance_check` | `OutputComplianceCheck` |
| `enhance_switch`          | `EnhanceSwitch`         |
| `frame_interpolate`       | `FrameInterpolate`      |
| `logo_add`                | `LogoAdd`               |

### `output_config` 字段

| 字段                        | 类型      | 说明                                       |
| ------------------------- | ------- | ---------------------------------------- |
| `storage_mode`            | String  | `Permanent` / `Temporary`，默认 `Temporary` |
| `media_name`              | String  | 输出媒体名，最长 64 字符                           |
| `class_id`                | Integer | 分类 ID，默认 `0`                             |
| `expire_time`             | String  | 过期时间，ISO 8601，例如 `2025-12-28T00:35:00Z`  |
| `duration`                | Float   | 生成时长，单位秒                                 |
| `resolution`              | String  | 分辨率档位，例如 `720P` / `1080P`                |
| `aspect_ratio`            | String  | 宽高比，例如 `16:9` / `9:16`                   |
| `audio_generation`        | String  | `Enabled` / `Disabled`                   |
| `person_generation`       | String  | `AllowAdult` / `Disallowed`              |
| `input_compliance_check`  | String  | `Enabled` / `Disabled`                   |
| `output_compliance_check` | String  | `Enabled` / `Disabled`                   |
| `enhance_switch`          | String  | `Enabled` / `Disabled`                   |
| `frame_interpolate`       | String  | `Enabled` / `Disabled`，Vidu 常用           |
| `logo_add`                | String  | `Enabled` / `Disabled`，Vidu 常用           |

时长字段建议保持顶层 `seconds` 和 `metadata.output_config.duration` 一致。如果只传一处，优先传顶层 `seconds`。

## 模型约束

| 参数            | 模型家族           | 可用值                                                        |
| ------------- | -------------- | ---------------------------------------------------------- |
| `Duration`    | `Kling`        | `5` / `10`，默认 `5`                                          |
| `Duration`    | `Hailuo`       | `6` / `10`，默认 `6`                                          |
| `Duration`    | `Vidu`         | `1` 到 `10`                                                 |
| `Duration`    | `GV`           | `8`，默认 `8`                                                 |
| `Duration`    | `OS`           | `4` / `8` / `12`，默认 `8`                                    |
| `Resolution`  | `Kling`        | `720P` / `1080P`，默认 `720P`                                 |
| `Resolution`  | `Hailuo`       | `768P` / `1080P`，默认 `768P`                                 |
| `Resolution`  | `Vidu`         | `720P` / `1080P`，默认 `720P`                                 |
| `Resolution`  | `GV`           | `720P` / `1080P`，默认 `720P`                                 |
| `Resolution`  | `OS`           | `720P`                                                     |
| `AspectRatio` | `Kling` 文生     | `16:9` / `9:16` / `1:1`，默认 `16:9`                          |
| `AspectRatio` | `Vidu` 文生 / 图生 | `16:9` / `9:16` / `4:3` / `3:4` / `1:1`，`4:3` / `3:4` 仅 q2 |
| `AspectRatio` | `GV`           | `16:9` / `9:16`，默认 `16:9`                                  |
| `AspectRatio` | `OS` 文生        | `16:9` / `9:16`，默认 `16:9`                                  |
| `AspectRatio` | `Hailuo`       | 暂不支持                                                       |

## 特殊规则

* `scene_type=motion_control` 必须提供视频参考，仅传图片会触发类似 `videoUrl must not be blank` 的错误。
* 动作控制视频参考可以用 `metadata.video_url`，也可以用 `metadata.file_infos` 且 `Category=Video`。
* `scene_type=lip_sync` / `identify-face` 不足 5 秒按 5 秒计。
* 素材列表最多支持 3 项。
* `Type=Url` 时必须有 `Url`。
* `Type=File` 时必须有 `FileId`。
* 顶层 `image` / `images` / `input_reference` 会作为图片素材处理。
* 顶层图片输入仅支持可访问的 `http(s)` 图片 URL 或文件 ID；当前不支持 `data:image/...;base64,...` 这类 base64 data URI。

## `file_infos` 子字段

素材列表可使用 `metadata.file_infos`，也兼容 `metadata.FileInfos`。

| 字段                                          | 说明                                                                                  |
| ------------------------------------------- | ----------------------------------------------------------------------------------- |
| `Type` / `type`                             | `File` / `Url`                                                                      |
| `Category` / `category`                     | `Image` / `Video`                                                                   |
| `FileId` / `file_id`                        | `Type=File` 时使用                                                                     |
| `Url` / `url`                               | `Type=Url` 时使用                                                                      |
| `Usage` / `usage`                           | 例如 `FirstFrame` / `Reference`                                                       |
| `ReferenceType` / `reference_type`          | 适用于 GV / Kling 的参考类型区分；Kling + `Category=Video` 时，`feature` 表示特征参考视频，`base` 表示待编辑视频 |
| `ObjectId` / `object_id`                    | 适用于 Vidu 主体 / 参考图模式                                                                 |
| `VoiceId` / `voice_id`                      | 适用于 `Vidu-q2`                                                                       |
| `KeepOriginalSound` / `keep_original_sound` | `Category=Video` 时有效                                                                |

## 默认可选模型

渠道选择 AIGC 后，前端默认模型列表包含：

* `Vidu-q2` / `Vidu-q2-pro` / `Vidu-q2-turbo` / `Vidu-q3-pro` / `Vidu-q3-turbo` / `Vidu-template`
* `Hunyuan-1.5` / `Mingmou-1.0` / `OS-2.0`
* `GV-3.1` / `GV-3.1-fast`
* `Kling-1.6` / `Kling-2.0` / `Kling-2.1` / `Kling-2.5` / `Kling-2.6` / `Kling-3.0` / `Kling-3.0-Omni` / `Kling-O1`
* `Hailuo-02` / `Hailuo-2.3` / `Hailuo-2.3-fast`
* `SV-1.5-pro` / `SV-1.0-pro` / `SV-1.0-pro-fast` / `SV-1.0-lite`
* `JV-3.0-pro`
* 组合计费模型，例如 `vidu-q2-pro-reference-1080p-offpeak`、`kling-2.6-motion-pro-1080p`、`kling-3.0-omni-1080p-ref-audio`、`hailuo-2.3-fast-1080p`、`sv-1.5-pro-1080p-audio`、`jv-3.0-pro`

当前仓库已内置映射到上述 `Kling` 型号；`Kling-O3`、`Kling-Mini` 还未作为预置型号加入文档与计费映射。

## 默认价格表

以下为默认单价，单位为元 / 秒。实际以账户侧开通能力与结算为准。

### Vidu

| 版本       | 场景     | 分辨率    |    单价 |
| -------- | ------ | ------ | ----: |
| q2       | 普通     | ≤720P  |  0.32 |
| q2       | 普通（错峰） | ≤720P  |  0.16 |
| q2       | 普通     | ≤1080P |  0.47 |
| q2       | 普通（错峰） | ≤1080P |  0.24 |
| q2       | 参考     | ≤540P  |  0.24 |
| q2       | 参考（错峰） | ≤540P  |  0.12 |
| q2       | 参考     | ≤720P  |  0.32 |
| q2       | 参考（错峰） | ≤720P  |  0.16 |
| q2       | 参考     | ≤1080P |  0.82 |
| q2       | 参考（错峰） | ≤1080P |  0.41 |
| q2-pro   | 普通     | ≤720P  |  0.35 |
| q2-pro   | 普通（错峰） | ≤720P  |  0.18 |
| q2-pro   | 普通     | ≤1080P |  0.70 |
| q2-pro   | 普通（错峰） | ≤1080P |  0.35 |
| q2-pro   | 参考     | ≤540P  |  0.27 |
| q2-pro   | 参考（错峰） | ≤540P  |  0.14 |
| q2-pro   | 参考     | ≤720P  |  0.35 |
| q2-pro   | 参考（错峰） | ≤720P  |  0.18 |
| q2-pro   | 参考     | ≤1080P |  0.90 |
| q2-pro   | 参考（错峰） | ≤1080P |  0.45 |
| q2-turbo | 普通     | ≤720P  |  0.25 |
| q2-turbo | 普通（错峰） | ≤720P  |  0.13 |
| q2-turbo | 普通     | ≤1080P |  0.47 |
| q2-turbo | 普通（错峰） | ≤1080P |  0.24 |
| q3-pro   | 普通     | ≤540P  |  0.44 |
| q3-pro   | 普通（错峰） | ≤540P  |  0.22 |
| q3-pro   | 普通     | ≤720P  | 0.937 |
| q3-pro   | 普通（错峰） | ≤720P  | 0.468 |
| q3-pro   | 普通     | ≤1080P |  1.00 |
| q3-pro   | 普通（错峰） | ≤1080P |  0.50 |
| q3-turbo | 普通     | ≤540P  |  0.25 |
| q3-turbo | 普通（错峰） | ≤540P  |  0.13 |
| q3-turbo | 普通     | ≤720P  |  0.38 |
| q3-turbo | 普通（错峰） | ≤720P  |  0.19 |
| q3-turbo | 普通     | ≤1080P |  0.50 |
| q3-turbo | 普通（错峰） | ≤1080P |  0.25 |
| template | 特效模板   | -      |  0.40 |

### Hunyuan / Mingmou / OS / GV

| 模型      | 版本       | 分辨率    |   单价 |
| ------- | -------- | ------ | ---: |
| Hunyuan | 1.5      | ≤720P  | 0.30 |
| Hunyuan | 1.5      | ≤1080P | 0.50 |
| Mingmou | 1.0      | ≤720P  | 0.30 |
| Mingmou | 1.0      | ≤1080P | 0.50 |
| OS      | 2.0      | 不区分    | 0.75 |
| GV      | 3.1      | 不区分    | 3.00 |
| GV      | 3.1-fast | 不区分    | 1.15 |

### Kling

| 版本              | 场景       | 分辨率             |   单价 |
| --------------- | -------- | --------------- | ---: |
| 3.0             | 无声       | ≤720P           | 0.60 |
| 3.0             | 有声       | ≤720P           | 0.90 |
| 3.0             | 无声       | ≤1080P          | 0.80 |
| 3.0             | 有声       | ≤1080P          | 1.20 |
| 3.0-Omni        | 无参考无声    | ≤720P           | 0.60 |
| 3.0-Omni        | 无参考有声    | ≤720P           | 0.80 |
| 3.0-Omni        | 有参考无声    | ≤720P           | 0.90 |
| 3.0-Omni        | 有参考有声    | ≤720P           | 1.10 |
| 3.0-Omni        | 无参考无声    | ≤1080P          | 0.80 |
| 3.0-Omni        | 无参考有声    | ≤1080P          | 1.00 |
| 3.0-Omni        | 有参考无声    | ≤1080P          | 1.20 |
| 3.0-Omni        | 有参考有声    | ≤1080P          | 1.40 |
| 2.6             | 无声       | 不区分             | 0.50 |
| 2.6             | 有声       | 不区分             | 1.00 |
| 2.6             | 动作控制 std | 不区分             | 0.50 |
| 2.6             | 动作控制 pro | 不区分             | 0.80 |
| O1              | 普通       | ≤720P           | 0.90 |
| O1              | 普通       | ≤1080P          | 1.20 |
| 2.5             | 普通       | ≤720P           | 0.30 |
| 2.5             | 普通       | ≤1080P          | 0.50 |
| 1.6 / 2.0 / 2.1 | 普通       | ≤720P           | 0.40 |
| 1.6 / 2.0 / 2.1 | 普通       | ≤1080P          | 0.70 |
| avatar          | 数字人      | ≤720P           | 0.40 |
| avatar          | 数字人      | ≤1080P          | 0.80 |
| identify-face   | 对口型      | 不区分，不足 5 秒按 5 秒 | 0.10 |

### Hailuo

| 版本       | 分辨率    |   单价 |
| -------- | ------ | ---: |
| 02 / 2.3 | ≤768P  | 0.33 |
| 02 / 2.3 | ≤1080P | 0.58 |
| 2.3-fast | ≤768P  | 0.23 |
| 2.3-fast | ≤1080P | 0.39 |

### SV

| 版本           | 分辨率        |    单价 |
| ------------ | ---------- | ----: |
| 1.5-pro      | ≤480P（无声）  |  0.08 |
| 1.5-pro      | ≤480P（有声）  |  0.16 |
| 1.5-pro      | ≤720P（无声）  | 0.172 |
| 1.5-pro      | ≤720P（有声）  | 0.346 |
| 1.5-pro      | ≤1080P（无声） | 0.388 |
| 1.5-pro      | ≤1080P（有声） | 0.778 |
| 1.0-pro      | ≤480P      | 0.146 |
| 1.0-pro      | ≤720P      | 0.308 |
| 1.0-pro      | ≤1080P     | 0.734 |
| 1.0-pro-fast | ≤480P      |  0.04 |
| 1.0-pro-fast | ≤720P      | 0.086 |
| 1.0-pro-fast | ≤1080P     | 0.206 |
| 1.0-lite     | ≤480P      | 0.098 |
| 1.0-lite     | ≤720P      | 0.206 |
| 1.0-lite     | ≤1080P     |  0.49 |

### JV

| 模型 | 版本      | 分辨率 |   单价 |
| -- | ------- | --- | ---: |
| JV | 3.0-pro | 不区分 | 1.00 |

## 相关页面

* [视频模型支持矩阵](/api-reference/videos/model-matrix)
* [国产视频模型生成](./generation)
* [国产视频模型查询](./query)