可灵 (Kling) — OpenAI 兼容格式

POST/v1/video/generations

通过 OpenAI 兼容端点调用可灵视频生成，请求与响应结构更统一。

Bearer Token

模型介绍

为方便已有 OpenAI SDK 的客户快速接入，宁享Token 同时提供可灵的 OpenAI 兼容端点。能力与原生端点一致，但请求结构与响应结构统一为 OpenAI 风格。

支持模型

模型	时长	分辨率	帧率	说明
kling-3.0	5s / 10s	720p / 1080p	24 fps	官方视频模型 ID（推荐）

⚠️ 模型名与官方 ID：带 v 的是【图片】，带【点号】的是【视频】。kling-v3 在快手可灵官方定义里是图片模型 ID（POST /v1/images/generations 的 model_name 默认值）， 本平台已接入该图片端点（见图像模型）；它不是本视频端点的可用模型 —— 向本端点传 kling-v3 会返回 400 invalid_model。 本端点请统一使用 kling-3.0。 完整对照表见原生格式页的「模型名与官方 ID」一节。

端点概览

端点	方法	说明
/v1/video/generations	POST	提交任务
/v1/video/generations/{task_id}	GET	查询任务

请求参数

Kling OpenAI 兼容请求参数

参数	类型	必填	默认值	描述
model	string	是	-	模型名称：官方视频 ID kling-3.0（kling-v3 不可用于本端点，见上方命名铁律）
prompt	string	是	-	视频描述
image_url	string	否	-	参考图 URL；存在时为图生视频，否则为文生视频
duration	integer	否	5	时长：5 / 10（秒）
seed	integer	否	随机	种子，用于结果复现

请求示例

curl -X POST /v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0",
    "prompt": "猫咪在草地上奔跑，阳光明媚",
    "duration": 5
  }'

import requests

HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

r = requests.post(
    "/v1/video/generations",
    headers=HEADERS,
    json={
        "model": "kling-3.0",
        "prompt": "猫咪在草地上奔跑，阳光明媚",
        "duration": 5,
    },
).json()
print(r["id"])  # task_id

图生视频示例

r = requests.post("/v1/video/generations", headers=HEADERS, json={
    "model": "kling-3.0",
    "prompt": "人物微微转头，微笑",
    "image_url": "https://example.com/portrait.png",
    "duration": 5,
})

响应示例

提交响应

提交响应

{
  "id": "task-abc123",
  "model": "kling-3.0",
  "status": "processing",
  "created": 1735662000
}

查询响应（succeeded）

查询响应

{
  "id": "task-abc123",
  "model": "kling-3.0",
  "status": "succeeded",
  "created": 1735662000,
  "videos": [
    {
      "url": "https://cdn.example.com/kling/abc.mp4",
      "duration": 5
    }
  ]
}

注意事项

• OpenAI 兼容端点的参数更简洁，但能力与原生端点一致，计费规则也相同。
• image_url 存在时为图生视频，否则为文生视频。
• negative_prompt 等高级参数请通过原生端点 /kling/v1/videos/text2video 使用。
• 任务查询可通过 任务管理 中的统一端点完成。