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

# 快手可灵

> 通过 OpenAI 风格 /v1/videos 调用 Kling。

# 快手可灵

通过 OpenAI Video 风格异步接口调用 **Kling**：

| 说明 | 方法 | 路径 |
| - | - | - |
| 创建视频任务 | `POST` | `/v1/videos` |
| 查询任务状态 | `GET` | `/v1/videos/{task_id}` |
| 获取视频内容 | `GET` | `/v1/videos/{task_id}/content` |

**API 主机：** `https://api.omniall.ai` · 鉴权 `Authorization: Bearer sk-...`。

## 模型

生成别名（大小写不敏感）：`kling-1.0`、`kling-1.5`、`kling-2.0`、`kling-2.1`、`kling-2.5`、`kling-3.0`、`kling-3.0-omni`、`kling-o1`。

专用：`kling-identify-face`（对口型）、`kling-avatar-720p`、`kling-avatar-1080p`。

以[模型广场](https://omniall.ai/pricing)为准。查询响应里的 `model` 可能是实际计费档位名。

## 默认值与优先级

| 项 | 规则 |
| - | - |
| 时长 | `seconds` > `duration` > metadata 时长字段 > **5 秒** |
| 分辨率 | `output_config.resolution` > `metadata.resolution` > `size` > **720P** |
| 有声 | 默认 **Disabled**（无声） |
| 动作档位 | 默认 **std** |
| 文生宽高比 | 默认 **16:9** |

## 场景用例

| 场景 | 关键字段 |
| - | - |
| 文生视频 | `prompt` + `seconds` + `output_config` |
| 单图生视频 | `image` + `prompt` |
| 多图生视频 | `images[]`（Omni） |
| 首尾帧 | `image` + `metadata.last_frame_url` |
| 动作控制 | `scene_type=motion_control` + 公网 `video_url` |
| 数字人 | `scene_type=avatar_i2v` 或专用模型 |
| 对口型 | `scene_type=lip_sync` 或 `kling-identify-face` |
| 参考视频 | `metadata.file_infos` |
| 多镜头 | `metadata.ext_info`（JSON **字符串**） |

动作控制必须提供**公网可访问**的参考视频 URL，否则报错。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.