Docs/Kling (可灵) Omni-Video API

Kling (可灵) Omni-Video API

多模态视觉语言 (MVL) 视频生成 -- 在单一接口中融合自然语言提示、视频/图片引用和主体参考，实现统一调用。

快速开始

从控制台获取 API 密钥

选择模型 (kling-video-o1 或 kling-v3-omni)

发送 POST 请求创建任务

轮询 GET 请求获取视频结果

认证方式

在所有请求中添加 Bearer Token 认证头：

Authorization: Bearer YOUR_API_KEY

可用模型

模型	API 名称	特性	价格 (8.5折)
Kling Video O1	`kling-video-o1`	3-10s, MVL 多模态, 音频, 按秒计费	低至 $0.0064/秒
Kling V3 Omni	`kling-v3-omni`	3-15s, MVL 多模态, 音频, 保留原声, 按秒计费	低至 $0.0064/秒

详细定价 (8.5折)

Kling Video O1

模式	音频	$/秒
std	-	$0.0633
std	on	$0.0956
pro	-	$0.0853
pro	on	$0.1280

Kling V3 Omni

模式	音频	保留原声	$/秒
std	-	-	$0.0633
std	-	on	$0.0853
std	on	-	$0.0956
pro	-	-	$0.0853
pro	-	on	$0.1059
pro	on	-	$0.1280

接口端点

POST/api/v1/video/generations

创建可灵 Omni-Video 视频生成任务。底层使用统一的 omni-video 端点 (POST /kling/v1/videos/omni-video)。

GET/api/v1/video/generations?task_id=xxx

查询任务状态并获取视频链接

请求参数

基本参数

model必填string

"kling-video-o1" 或 "kling-v3-omni"

promptstring

文本提示词（不超过2500字符）。描述期望的视频内容。

image_listarray

图片引用数组 { image_url, type }。type: "first_frame" 或 "end_frame"。

video_listarray

视频引用数组 { video_url, refer_type, keep_original_sound }。refer_type: "feature" 或 "base"。keep_original_sound: "yes" 或 "no"。

element_listarray

主体引用数组 { element_id }。用于保持角色/物体的一致性。

modestring

"std"（标准）或 "pro"（高品质）。默认："std"

durationstring

O1："3" 到 "10"。V3 Omni："3" 到 "15"。默认："5"

soundstring

"on" 或 "off"。是否生成音频。默认："off"

aspect_ratiostring

"16:9"、"9:16" 或 "1:1"

callback_urlstring

完成后的回调 URL

高级参数

multi_shotboolean

是否生成多镜头视频

shot_typestring

镜头类型控制

multi_promptstring

多段提示词，用于场景切换

watermark_infoobject

{ enabled: true/false } - 是否生成含水印版本

代码示例

curl -X POST https://apimodels.app/api/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-video-o1",
    "prompt": "A girl dancing on the beach at sunset, cinematic lighting",
    "mode": "std",
    "duration": "5",
    "aspect_ratio": "16:9"
  }'

响应格式

创建任务响应

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "clxxx...",
    "state": "pending",
    "model": "kling-video/kling-video-o1"
  }
}

成功响应

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "clxxx...",
    "state": "completed",
    "model": "kling-video/kling-video-o1",
    "resultUrls": ["https://...video.mp4"],
    "createTime": 1705123450000,
    "completeTime": 1705123500000
  }
}

失败响应

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "clxxx...",
    "state": "failed",
    "model": "kling-video/kling-video-o1",
    "failMsg": "Content policy violation"
  }
}

任务状态

pending任务已排队，等待处理

processing视频生成中

completed视频生成成功

failed视频生成失败

错误码

400请求错误 - 参数缺失或无效

401未授权 - API 密钥无效

402余额不足 - 积分不够

404未找到 - 任务 ID 不存在

500服务器内部错误

注意事项

*视频文件保存 7 天，请及时下载
*Omni-Video 使用统一端点，无需区分文生视频和图生视频
*至少需要提供 prompt、image_list 或 video_list 中的一个
*O1 支持 3-10 秒时长，V3 Omni 支持 3-15 秒时长，均按秒计费
*两个模型均支持音频生成（设置 sound: "on"）
*使用 video_list 并设置 refer_type: "base" 进行视频编辑/再创作
*建议每 5-10 秒轮询一次状态

在 Playground 中试用获取 API 密钥

模型

API 名称

特性

价格 (8.5折)

Kling Video O1

kling-video-o1

3-10s, MVL 多模态, 音频, 按秒计费

低至 $0.0064/秒

Kling V3 Omni

kling-v3-omni

3-15s, MVL 多模态, 音频, 保留原声, 按秒计费

低至 $0.0064/秒

模式

音频

$/秒

std

$0.0633

std

$0.0956

pro

$0.0853

pro

$0.1280

模式

音频

保留原声

$/秒

std

$0.0633

std

$0.0853

std

$0.0956

pro

$0.0853

pro

$0.1059

pro

$0.1280

请求参数

基本参数

model必填string

"kling-video-o1" 或 "kling-v3-omni"

promptstring

文本提示词（不超过2500字符）。描述期望的视频内容。

image_listarray

图片引用数组 { image_url, type }。type: "first_frame" 或 "end_frame"。

video_listarray

视频引用数组 { video_url, refer_type, keep_original_sound }。refer_type: "feature" 或 "base"。keep_original_sound: "yes" 或 "no"。

element_listarray

主体引用数组 { element_id }。用于保持角色/物体的一致性。

modestring

"std"（标准）或 "pro"（高品质）。默认："std"

durationstring

O1："3" 到 "10"。V3 Omni："3" 到 "15"。默认："5"

soundstring

"on" 或 "off"。是否生成音频。默认："off"

aspect_ratiostring

"16:9"、"9:16" 或 "1:1"

callback_urlstring

完成后的回调 URL

代码示例

curl -X POST https://apimodels.app/api/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-video-o1",
    "prompt": "A girl dancing on the beach at sunset, cinematic lighting",
    "mode": "std",
    "duration": "5",
    "aspect_ratio": "16:9"
  }'

响应格式

创建任务响应

{ "code": 200, "msg": "success", "data": { "taskId": "clxxx...", "state": "pending", "model": "kling-video/kling-video-o1" } }

成功响应

{ "code": 200, "msg": "success", "data": { "taskId": "clxxx...", "state": "completed", "model": "kling-video/kling-video-o1", "resultUrls": ["https://...video.mp4"], "createTime": 1705123450000, "completeTime": 1705123500000 } }

失败响应

{ "code": 200, "msg": "success", "data": { "taskId": "clxxx...", "state": "failed", "model": "kling-video/kling-video-o1", "failMsg": "Content policy violation" } }

注意事项

*视频文件保存 7 天，请及时下载

*Omni-Video 使用统一端点，无需区分文生视频和图生视频

*至少需要提供 prompt、image_list 或 video_list 中的一个

*O1 支持 3-10 秒时长，V3 Omni 支持 3-15 秒时长，均按秒计费

*两个模型均支持音频生成（设置 sound: "on"）

*使用 video_list 并设置 refer_type: "base" 进行视频编辑/再创作

*建议每 5-10 秒轮询一次状态