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

# Kling 系列介绍

> 了解 Kling 系列在 AIOAGI 中的图生视频、Omni 视频、多素材参考和任务轮询能力。

`Kling` 系列是可灵视频生成模型系列。它适合图生视频、Omni 多模态视频、角色动作生成、产品动态展示、影视分镜、广告创意和社媒短视频素材生产。

AIOAGI 将 Kling、Seedance、Seedream、GPT、Claude、DeepSeek、Gemini、Qwen 和 Vibe Coding 等模型聚合到统一平台。你可以使用 AIOAGI API Key，通过 Kling 视频任务接口提交生成任务，再轮询任务结果。模型名称、价格、模式、时长、音频支持和上线状态可能变化，请以 **控制台** 和 **开发者指南** 为准。

<Warning>
  上线生产前，请先确认你的 API Key 所属 Token 组支持目标 Kling 模型。不同 Token 组可用模型、额度、限流、回调和计费方式可能不同。
</Warning>

## 系列定位

<CardGroup cols={2}>
  <Card title="Kling v3 图生视频" icon="image">
    适合基于单张首帧图片生成动态视频。可用于商品展示、人物动作、镜头推进和场景动效。
  </Card>

  <Card title="Kling v3 Omni" icon="film">
    适合同时参考图片、视频和元素素材的复杂视频生成。可在提示词中引用不同素材。
  </Card>

  <Card title="标准与高表现模式" icon="sliders-horizontal">
    常见模式包括 `std` 和 `pro`。不同模式的速度、质量、尾帧支持和价格可能不同。
  </Card>

  <Card title="异步任务工作流" icon="route">
    视频生成通过提交任务和轮询结果完成。适合用队列管理提交、查询、下载和失败重试。
  </Card>
</CardGroup>

## 当前参考模型

| 模型 ID                                  | 主要能力           | 适用建议                      |
| -------------------------------------- | -------------- | ------------------------- |
| `kling-v3`                             | 图生视频           | 适合单图驱动的视频生成任务。            |
| `kling-v3-omni`                        | Omni 视频        | 适合多图、多视频、多元素参考的视频生成任务。    |
| `kling/kling-v3-omni-video-generation` | 百炼风格 Omni 视频别名 | 如果控制台展示该别名，请按控制台和开发者指南配置。 |

<Info>
  Kling 模型 ID 和接口形态来自当前本地接入脚本与资料。生产配置前，请在 **控制台**、`GET /models` 或 **开发者指南** 中重新确认。
</Info>

## 适合场景

* **商品动效**：把商品图转成展示镜头，突出材质、转场和使用场景。
* **广告创意**：快速生成短片样片，用于评审镜头语言和视觉方向。
* **角色动作**：基于人物或角色图片生成动作片段，验证姿态和运动趋势。
* **多素材融合**：用 Omni 视频能力组合图片、视频和元素参考，生成复杂创意片段。
* **影视分镜**：为故事板、镜头草案和短片预演生成动态素材。

## AIOAGI 使用方法

<Steps>
  <Step title="创建 API Key">
    登录 AIOAGI 控制台，在 **令牌** 或 **API Key** 页面创建密钥。视频任务建议单独使用 Token 组，便于额度控制和成本追踪。
  </Step>

  <Step title="确认模型权限">
    在 **控制台**、**开发者指南** 或 `GET /models` 返回结果中确认目标 Kling 模型可用。模型别名以控制台展示为准。
  </Step>

  <Step title="配置视频任务端点">
    在服务端保存 API Key 和 base URL。常用端点为 `https://api.aiearth.dev/v1`，也可以按网络情况使用 `https://api.aiearth.vip/v1`。
  </Step>

  <Step title="提交异步任务">
    图生视频使用 `POST /videos/image2video`。Omni 视频使用 `POST /videos/omni-video`。根据任务输入准备图片、视频和提示词。
  </Step>

  <Step title="轮询并保存结果">
    使用对应的 `GET` 查询接口轮询任务。任务进入 `succeed`、`succeeded` 或 `completed` 后，读取视频 URL 并转存到你的业务存储。
  </Step>
</Steps>

## API 调用

具体请求代码、参数表、任务轮询和返回说明请查看 [Kling 系列 API](/api-reference/endpoint/kling.mdx)。模型介绍页只保留能力、选型和使用流程说明。

## 核心参数

| 参数             | 说明                                            |
| -------------- | --------------------------------------------- |
| `model_name`   | Kling 模型 ID，例如 `kling-v3` 或 `kling-v3-omni`。  |
| `prompt`       | 描述视频内容、动作、镜头和风格。Omni 视频可用素材占位符引用图片或视频。        |
| `image`        | 图生视频首帧图片。支持公网可访问 URL 或 Base64。                |
| `image_list`   | Omni 视频参考图片列表。常见结构为 `{ "image_url": "..." }`。 |
| `video_list`   | Omni 视频参考视频列表。可用于参考动作、声音或基础视频。                |
| `mode`         | 常见值为 `std` 和 `pro`。实际支持范围以控制台和开发者指南为准。        |
| `duration`     | 常见值为 `5` 或 `10` 秒。实际支持范围以模型和 Token 组为准。       |
| `aspect_ratio` | Omni 视频常见值包括 `16:9`、`9:16`、`1:1`。             |
| `sound`        | 图生视频音效开关，常见值为 `on` 或 `off`。                   |
| `callback_url` | 可选。任务完成后的回调地址，是否支持以当前接口说明为准。                  |

## 提示词建议

* 图生视频要说明主体动作、镜头运动、场景变化和期望节奏。
* Omni 视频要在提示词中明确引用素材，例如 `<<<image_1>>>`、`<<<image_2>>>`。
* 如果你传入参考视频，请说明要保留的动作、声音或镜头特征。
* 对生产任务固定 `mode`、`duration`、`aspect_ratio` 等关键参数，减少批量输出波动。
* 保存成功样例和失败样例，沉淀为后续批量生成的提示词模板。

## 排障建议

* 遇到 `401`，检查 API Key 和 `Authorization` 请求头。
* 遇到 `403`，检查账户余额、Token 组额度和模型权限。
* 遇到 `404` 或模型不存在，核对 base URL、接口路径、模型 ID 和 `task_id`。
* 遇到任务长时间 `submitted` 或 `processing`，降低并发并延长轮询间隔。
* 遇到生成结果为空，记录原始响应并检查视频 URL 字段是否在 `data`、`output` 或 `metadata` 中。

<Tip>
  Kling 和 Seedance 都属于视频生成模型。建议你用同一套任务队列封装提交、轮询、下载、失败重试和费用记录，再按模型能力选择具体接口。
</Tip>