Kling Video O1

可灵 Kling Video O1（Omni One）是快手推出的行业首个统一多模态视频大模型。模型将文生视频、图生视频与视频编辑整合于单一引擎，涵盖主体参考、局部重绘、风格重塑、首尾帧过渡及视频续写等全套能力。支持至多 7 个主体联动参考与多视角锁定，可完美维持角色与道具一致性，并支持自然语言对话式“P视频”，适用于全流程影视创作与广告制作。

Base URL

https://api.icreat.ai

认证

所有 API 请求需要通过 API Key 进行认证。您可以在控制台获取 API Key。

export ICREAT_API_KEY="your-api-key-here"

HTTP 请求头

import os

API_KEY = os.environ.get("ICREAT_API_KEY")
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer " + API_KEY,
}

保护好您的 API Key

切勿在客户端代码或公开仓库中暴露您的 API Key。请使用环境变量或后端代理。

代码示例

图片/视频生成采用三段式异步调用：先提交任务获取 task_id，再轮询任务状态，最后在状态为 SUCCEEDED 时获取生成结果。以下示例使用同一 task_id 串联三个步骤。

1. 提交任务

向提交接口发送生成请求。

POST/v1/task/submit/kwaivgi/kling-video-o1

curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST "https://api.icreat.ai/v1/task/submit/kwaivgi/kling-video-o1" \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "让<<<image_1>>>中的人物向镜头挥手",
    "image_list": [
      {
        "image_url": "https://example.com/first-frame.png"
      }
    ],
    "mode": "pro",
    "aspect_ratio": "16:9",
    "duration": "5"
  }'

2. 轮询状态

使用 task_id 查询任务进度。响应体仅包含 status 字段。

POST/v1/task/query-status

curl --connect-timeout 10 --max-time 60 \
  -X POST "https://api.icreat.ai/v1/task/query-status" \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "task_id": "task-xxx"
  }'

3. 获取结果

任务成功后拉取最终输出。

POST/v1/task/get-result

curl --connect-timeout 10 --max-time 60 \
  -X POST "https://api.icreat.ai/v1/task/get-result" \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "task_id": "task-xxx"
  }'

输入参数

提交任务 — 输入参数

以下参数在提交任务请求体中被接受。

总计: 20 必填: 7 可选: 13

promptstring

单镜头文本提示词。当 multi_shot=false，或 shot_type=intelligence 时必填

negative_promptstring

负向提示词，用于描述不希望出现在视频中的内容

multi_shotboolean必填

是否启用多镜头生成

shot_typestring

当 multi_shot=true 时必填。支持 customize、intelligence

multi_promptobject[]

当 multi_shot=true 且 shot_type=customize 时必填，数量为 1-6

image_listobject[]

图片素材列表

element_listobject[]

主体素材列表

video_listobject[]

视频素材列表

soundstring必填

是否生成声音。支持 on、off；存在 video_list 时只能设置为 off

modestring

生成模式。支持 std、pro、4k；std 对应 720p，pro 对应 1080p

aspect_ratiostring

输出宽高比。支持 16:9、9:16、1:1

durationstring

视频时长，单位为秒

watermark_infoobject

水印配置，当前仅支持 enabled 字段

image_urlstring必填

图片 URL

typestring

图片类型。支持 first_frame、end_frame

element_idstring必填

主体库中的主体 ID

video_urlstring必填

视频 URL

refer_typestring

视频引用类型。支持 feature、base

keep_original_soundstring必填

是否保留原视频声音。支持 yes、no

enabledboolean必填

是否启用水印

轮询状态 — 输入参数

总计: 1 必填: 1 可选: 0

task_idstring必填

提交任务接口返回的任务 ID。

获取结果 — 输入参数

总计: 1 必填: 1 可选: 0

task_idstring必填

提交任务接口返回的任务 ID。

输出参数

提交任务 — 输出参数

总计: 1

task_idstring

提交任务接口返回的任务 ID。

轮询状态 — 输出参数

总计: 1

statusstring

当前任务状态。当状态为 SUCCEEDED 时可获取结果。

获取结果 — 输出参数

响应体为资源对象数组（array[object]）。

总计: 3

typestring

资源类型，视频模型为 Video。

urlstring

预览/访问 URL。

download_urlstring

下载 URL。

LLM友好的提示词

以下是一段 LLM 友好的 Markdown 提示词，可复制到 Cursor、ChatGPT 等 AI 助手中，帮助 AI 理解本模型的 API 接入方式、调用流程与关键参数。点击「复制LLM提示词」按钮或下方代码块均可复制全文。

# kwaivgi/kling-video-o1

> 可灵 Kling Video O1（Omni One）是快手推出的行业首个统一多模态视频大模型。

## 概述

通过 iCreat 三段式异步任务 API 提交生成请求，轮询任务状态后在成功时获取视频资源 URL。

## API 信息

- **Base URL**：`https://api.icreat.ai`
- **Submit endpoint (POST)**：`/v1/task/submit/kwaivgi/kling-video-o1`
- **Poll endpoint (POST)**：`/v1/task/query-status`
- **Get result endpoint (POST)**：`/v1/task/get-result`
- **Model ID**：`kwaivgi/kling-video-o1`
- **认证**：`Authorization: Bearer ${ICREAT_API_KEY}`

## 调用流程

1. **Submit**：POST submit 路径，Body 见输入要点；响应 `{ "task_id": "..." }`
2. **Poll**：POST `/v1/task/query-status`，Body `{ "task_id": "..." }`；响应**仅** `{ "status": "SUBMITTED|SUCCEEDED|FAILED" }`
3. **Get result**：`status` 为 `SUCCEEDED` 时 POST `/v1/task/get-result`；响应为顶层数组，`type` 为 `Video` 时读取 `url` 或 `download_url`

### 输入要点

- 请求体为顶层扁平字段
- 必填：`multi_shot`, `sound`, `element_id`, `video_url`, `keep_original_sound`, `enabled`
- 可选：`prompt`, `negative_prompt`, `shot_type`, `multi_prompt`, `image_list`, `element_list`, `video_list`, `mode`, `aspect_ratio`, `duration`, `watermark_info`, `refer_type`
- `prompt`（可选）：单镜头文本提示词。当 `multi_shot=false`，或 `shot_type=intelligence` 时必填
- `negative_prompt`（可选）：负向提示词，用于描述不希望出现在视频中的内容
- `shot_type`（可选）：当 `multi_shot=true` 时必填。支持 `customize`、`intelligence`
- `multi_prompt`（可选）：当 `multi_shot=true` 且 `shot_type=customize` 时必填，数量为 1-6
- `sound`（必填）：是否生成声音。支持 `on`、`off`；存在 `video_list` 时只能设置为 `off`
- `mode`（可选）：生成模式。支持 `std`、`pro`、`4k`；`std` 对应 720p，`pro` 对应 1080p
- `aspect_ratio`（可选）：输出宽高比。支持 `16:9`、`9:16`、`1:1`
- `watermark_info`（可选）：水印配置，当前仅支持 `enabled` 字段
- `refer_type`（可选）：视频引用类型。支持 `feature`、`base`
- `keep_original_sound`（必填）：是否保留原视频声音。支持 `yes`、`no`

### 输出要点

- 轮询：只看 `status`
- 结果：顶层 `[{ "type": "Video", "url": "...", "download_url": "..." }]`

## 注意事项

- 三段式须用同一 `task_id` 串联；不可跳过轮询
- `FAILED` 为终态，需排查请求参数或参考内容