## 创建任务
`POST /kling/v1/videos/omni-video`
```bash cURL theme={null}
curl --request POST \
--url https://www.anyfast.ai/kling/v1/videos/omni-video \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model_name": "kling-o1",
"prompt": "<<>> 中的人物走进雨后的霓虹街道，电影感跟拍",
"image_list": [
{"image_url": "https://example.com/character.png"}
],
"mode": "pro",
"aspect_ratio": "16:9",
"duration": "7",
"sound": "off"
}'
```
```json 200 theme={null}
{
"id": "860260753860210752",
"task_id": "860260753860210752",
"object": "video",
"model": "kling-video-o1",
"status": "",
"progress": 0,
"created_at": 1773130665
}
```
## 请求头
Bearer 身份验证，格式为 `Bearer YOUR_API_KEY`。
请求数据格式，固定为 `application/json`。
## 请求参数
模型名称，固定为 `kling-o1`。
生成或编辑指令，最长 2500 字符。使用 `<<>>`、`<<>>` 和 `<<>>` 引用对应数组中的素材。
参考图片列表，也用于指定首帧和尾帧。
图片 URL 或不带 `data:image/...;base64,` 前缀的原始 Base64。
帧类型，可选 `first_frame` 或 `end_frame`。尾帧必须与首帧同时传入。
旧版主体列表。提示词中按数组顺序使用 `<<>>`、`<<>>` 引用。
旧版主体管理接口返回的主体 ID。
参考视频列表，最多一段。可用于直接编辑源视频，或参考其内容、动作、风格和运镜。
可公开访问的视频 URL。仅支持 URL，不支持 Base64。
`base` 表示直接编辑源视频；`feature` 表示参考视频特征生成新视频。
是否保留参考视频原声，可选 `yes` 或 `no`。
输出模式。`std` 为 720p，`pro` 为 1080p。Kling O1 不支持 `4k`。
画面比例，可选 `16:9`、`9:16` 或 `1:1`。没有首帧或参考视频时需要设置；视频编辑不支持该参数。
视频时长，支持 3–10 秒。`refer_type` 为 `base` 时该参数不生效，输出时长跟随参考视频。
Kling O1 不支持原生音频生成，请使用 `off`。传入 `video_list` 时必须为 `off`。
平台水印配置。
是否添加平台水印。
## 参数规则
### 多模态引用
* 图片、主体和视频分别使用 `<<>>`、`<<>>`、`<<>>` 引用，编号从 1 开始并与数组顺序对应。
* Kling O1 为单镜头模型，不支持 `multi_shot`、`shot_type` 或 `multi_prompt`。
* 首尾帧模式最多传入两张图片，尾帧必须与首帧同时使用，并且不能同时引用主体。
### 图片要求
* 支持 JPG、JPEG、PNG；单张不超过 10 MB。
* 宽高均不得小于 300 px，宽高比范围为 1:2.5 至 2.5:1。
* 支持可公开访问的 URL，或不带 data URI 前缀的原始 Base64。
### 视频要求
* 支持 MP4、MOV，最多一段视频且不超过 200 MB。
* 视频至少 3 秒，宽高范围 720–2160 px，帧率 24–60 fps，宽高比范围为 1:2.5 至 2.5:1。
* `refer_type: "base"` 用于直接编辑源视频，不能与首尾帧同时使用，`duration` 不生效。
* `refer_type: "feature"` 用于参考内容、动作、风格或运镜，可在提示词中要求生成上一镜或下一镜。
* 传入视频时必须将 `sound` 设为 `off`；通过 `keep_original_sound` 决定是否保留源视频原声。
### 素材数量
| 场景 | 数量限制 |
| ------------------- | ------------------------------- |
| 无参考视频，仅使用多图主体 | 参考图片与多图主体的图片总数不超过 7 |
| 无参考视频，仅使用视频主体 | 视频主体不超过 3 个 |
| 无参考视频，同时使用视频主体和多图主体 | 视频主体不超过 3 个；参考图片与多图主体的图片总数不超过 4 |
| 有参考视频，仅使用多图主体 | 参考图片与多图主体的图片总数不超过 4 |
| 有参考视频，仅使用视频主体 | 视频主体不超过 1 个 |
## 创建响应
AnyFast 任务 ID。
任务 ID，与 `id` 相同。
对象类型，固定为 `video`。
实际调用的模型。
初始任务状态。
初始任务进度。
任务创建 Unix 时间戳。
## 更多场景调用示例
### 文生视频
```json theme={null}
{
"model_name": "kling-o1",
"prompt": "一艘帆船穿过金色晨雾，航拍镜头缓慢前进",
"mode": "pro",
"aspect_ratio": "16:9",
"duration": "6",
"sound": "off"
}
```
### 图片与主体参考
```json theme={null}
{
"model_name": "kling-o1",
"prompt": "让 <<>> 中的人物穿着 <<>> 的服装走进咖啡馆",
"image_list": [
{"image_url": "https://example.com/character.png"}
],
"element_list": [
{"element_id": 123456789}
],
"mode": "pro",
"aspect_ratio": "16:9",
"duration": "5",
"sound": "off"
}
```
### 视频编辑
```json theme={null}
{
"model_name": "kling-o1",
"prompt": "将 <<>> 的天气改为下雪，并把画面调整为电影色调",
"video_list": [
{
"video_url": "https://example.com/source.mp4",
"refer_type": "base",
"keep_original_sound": "yes"
}
],
"mode": "pro",
"sound": "off"
}
```
### 视频参考与续写
```json theme={null}
{
"model_name": "kling-o1",
"prompt": "参考 <<>> 的人物动作和运镜，生成紧接其后的下一镜",
"video_list": [
{
"video_url": "https://example.com/reference.mp4",
"refer_type": "feature",
"keep_original_sound": "no"
}
],
"mode": "pro",
"aspect_ratio": "16:9",
"duration": "5",
"sound": "off"
}
```
### 首尾帧生成
```json theme={null}
{
"model_name": "kling-o1",
"prompt": "镜头从清晨自然过渡到夜晚，保持建筑结构一致",
"image_list": [
{"image_url": "https://example.com/first.png", "type": "first_frame"},
{"image_url": "https://example.com/end.png", "type": "end_frame"}
],
"mode": "pro",
"duration": "6",
"sound": "off"
}
```
## FAQ
### 支持哪些输入素材？
* 图片最多 7 张，格式为 JPG/JPEG/PNG，宽高均不小于 300 px，单张不超过 10 MB。
* 视频最多 1 段，格式为 MP4/MOV，时长至少 3 秒、分辨率不超过 2K、文件不超过 200 MB。
* 多图主体最多使用 4 张不同角度的图片建立。
* 有参考视频时，图片与主体合计最多 4 个；没有参考视频时合计最多 7 个。
### 如何在提示词中引用素材？
按数组顺序使用 `<<>>`、`<<>>` 和 `<<>>`。编号必须与 `image_list`、`element_list`、`video_list` 中的顺序一致。
### 首尾帧和视频编辑有什么限制？
仅使用尾帧不受支持。尾帧必须与首帧同时提供；首尾帧模式不能同时使用主体。`refer_type: "base"` 的视频编辑也不能使用首尾帧，且输出时长跟随源视频。
### 支持哪些清晰度和时长？
`std` 为 720p，`pro` 为 1080p；不支持 4K。输出时长支持 3–10 秒，视频编辑场景除外。
## 查询任务（单个）
`GET /kling/v1/videos/omni-video/{task_id}`
```bash cURL theme={null}
curl --request GET \
--url https://www.anyfast.ai/kling/v1/videos/omni-video/860260753860210752 \
--header 'Authorization: Bearer YOUR_API_KEY'
```
创建任务接口返回的任务 ID。
### 响应字段
业务状态码；成功时为 `0`。
响应消息。
请求追踪 ID。
任务 ID。
`submitted`、`processing`、`succeed` 或 `failed`。
任务失败或状态说明。
成功生成的视频列表。
视频 ID。
无水印视频链接。
带水印视频链接。
实际视频时长。
是否启用平台水印。
最终扣减的资源单位。
最终扣减的余额额度。
任务创建时间戳，毫秒。
任务更新时间戳，毫秒。
```json 200 theme={null}
{
"code": 0,
"message": "SUCCEED",
"request_id": "req_123456789",
"data": {
"task_id": "860260753860210752",
"task_status": "succeed",
"task_status_msg": "",
"task_result": {
"videos": [
{
"id": "video_123456789",
"url": "https://example.com/generated.mp4",
"watermark_url": "https://example.com/generated-watermark.mp4",
"duration": "7"
}
]
},
"watermark_info": {"enabled": false},
"final_unit_deduction": "1",
"final_balance_deduction": {"quota": "0"},
"created_at": 1773130665000,
"updated_at": 1773130765000
}
}
```
可灵会在生成后 30 天删除任务中的图片和视频 URL。请在有效期内下载并保存结果。
## 主体接口
| 操作 | 方法与路径 |
| ---------- | ---------------------------------------- |
| 创建自定义主体 | `POST /kling/v1/general/custom-elements` |
| 查询自定义主体列表 | `GET /kling/v1/general/custom-elements` |
| 查询官方预置主体列表 | `GET /kling/v1/general/presets-elements` |
| 删除自定义主体 | `POST /kling/v1/general/delete-elements` |
以下内容严格使用可灵旧版主体 API。
## 创建主体
`POST /kling/v1/general/custom-elements`
```bash cURL theme={null}
curl --request POST \
--url https://www.anyfast.ai/kling/v1/general/custom-elements \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"element_name": "series-character",
"element_description": "视频系列主角",
"element_frontal_image": "https://example.com/front.png",
"element_refer_list": [
{"image_url": "https://example.com/side.png"},
{"image_url": "https://example.com/close-up.png"}
],
"tag_list": [{"tag_id": "o_102"}]
}'
```
```json 200 theme={null}
{
"code": 0,
"message": "SUCCEED",
"request_id": "request-id",
"data": {
"element_id": 863121023120580662,
"element_name": "series-character",
"element_description": "视频系列主角",
"element_frontal_image": "https://example.com/front.png",
"element_refer_list": [
{"image_url": "https://example.com/side.png"}
],
"tag_list": [
{"id": "o_102", "name": "人物", "description": "string"}
],
"owned_by": "creator-id"
}
}
```
### 请求头
Bearer 身份验证，格式为 `Bearer YOUR_API_KEY`。
请求数据格式，固定为 `application/json`。
### 请求体
主体名称，最长 20 个字符。
主体描述，最长 100 个字符。
正面参考图 URL 或不带 data URI 前缀的原始 Base64。
其他角度或特写参考图，至少 1 张、最多 3 张。
参考图片 URL 或原始 Base64。
主体标签列表。
`o_101` 热梗、`o_102` 人物、`o_103` 动物、`o_104` 道具、`o_105` 服饰、`o_106` 场景、`o_107` 特效、`o_108` 其他。
图片支持 JPG、JPEG、PNG，单张不超过 10 MB，宽高均不小于 300 px，宽高比为 1:2.5 至 2.5:1。
### 创建响应
`0` 表示成功。
响应消息。
请求追踪 ID。
主体 ID，在 O1 请求的 `element_list` 中使用。
主体名称。
主体描述。
正面参考图。
其他角度参考图。
主体标签。
主体来源；`kling` 表示官方主体。
## 查询自定义主体（列表）
`GET /kling/v1/general/custom-elements?pageNum=1&pageSize=30`
```bash cURL theme={null}
curl --request GET \
--url 'https://www.anyfast.ai/kling/v1/general/custom-elements?pageNum=1&pageSize=30' \
--header 'Authorization: Bearer YOUR_API_KEY'
```
页码，范围 1–1000。
每页数量，范围 1–500。
响应顶层包含 `code`、`message`、`request_id` 和 `data[]`。每个主体包含创建响应中的主体字段，并额外返回 `final_unit_deduction`。
## 查询预置主体（列表）
`GET /kling/v1/general/presets-elements?pageNum=1&pageSize=30`
```bash cURL theme={null}
curl --request GET \
--url 'https://www.anyfast.ai/kling/v1/general/presets-elements?pageNum=1&pageSize=30' \
--header 'Authorization: Bearer YOUR_API_KEY'
```
页码，范围 1–1000。
每页数量，范围 1–500。
响应结构与自定义主体列表一致，但不包含 `final_unit_deduction`；官方预置主体的 `owned_by` 为 `kling`。
## 删除自定义主体
`POST /kling/v1/general/delete-elements`
```bash cURL theme={null}
curl --request POST \
--url https://www.anyfast.ai/kling/v1/general/delete-elements \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{"element_id": "863121023120580662"}'
```
需要删除的自定义主体 ID。官方预置主体不可删除。
```json 200 theme={null}
{
"code": 0,
"message": "SUCCEED",
"request_id": "request-id"
}
```