更新日期：2026-06-06

Kling 视频生成

Crazyrouter 当前对客公开的 Kling 视频族按官方协议拆成两条模型家族：

路由族	提交路径	查询路径	当前公开模型
标准 Kling 视频	`POST /kling/v1/videos/text2video` `POST /kling/v1/videos/image2video` `POST /kling/v1/videos/multi-image2video`	`GET /kling/v1/videos/text2video/{task_id}` `GET /kling/v1/videos/image2video/{task_id}` `GET /kling/v1/videos/multi-image2video/{task_id}`	`kling-v2-5-turbo` `kling-v2-6` `kling-v3`
Kling Omni 视频	`POST /kling/v1/videos/omni-video`	`GET /kling/v1/videos/omni-video/{task_id}`	`kling-v3` `kling-v3`

所有任务都是异步的。查询结果会优先返回 Crazyrouter 归档地址，例如 https://media.crazyrouter.com/...。

首批 5 模型与能力

模型	路由族	当前对客能力	验证状态	计费维度摘要
`kling-v2-5-turbo`	标准 Kling 视频	文生视频、图生视频、首尾帧、参考图生视频	`Beta`	`mode + duration`
`kling-v2-6`	标准 Kling 视频	文生视频、图生视频、首尾帧、参考图生视频、声音、voice control、动作控制	`Beta`	`mode + duration + sound + voice control`
`kling-v3`	标准 Kling 视频	文生视频、图生视频、首尾帧、参考图生视频、动作控制、标准路由元素引用	`Beta`	`mode + duration + sound`；动作控制单独计费桶
`kling-v3`	Kling Omni 视频	Omni 视频、图片/元素/视频/声音引用	`Beta`	`mode + duration + sound + video input`

对客能力与字段口径以官方 Kling 协议为主；Crazyrouter 只把第三方渠道当作内部 provider，不把第三方协议暴露给客户。价格以实时 Pricing 页面为准。

当前 Kling 首批 5 模型已经按官方字段与 pricing 矩阵对齐，但能力状态统一先标记为 Beta。等上线后一段时间，我们会结合脚本统计和生产日志逐项转正。

标准 Kling 视频

POST /kling/v1/videos/text2video
POST /kling/v1/videos/image2video
POST /kling/v1/videos/multi-image2video

当前推荐模型

kling-v2-5-turbo
kling-v2-6
kling-v3

文生视频参数

参数	类型	必填	说明
`model_name`	string	是	标准 Kling 视频模型
`prompt`	string	是	视频描述提示词
`image_urls`	array[string]	否	官方首帧 / 首尾帧输入。引用 `@element_name` 时建议显式传入
`negative_prompt`	string	否	负面提示词
`duration`	string/integer	否	常用 `5` 或 `10`
`aspect_ratio`	string	否	如 `16:9`、`9:16`、`1:1`
`mode`	string	否	生成模式，如 `std`、`pro`
`sound`	string / boolean	否	推荐使用官方值 `on` / `off`
`multi_shots`	boolean	否	官方多镜头开关；兼容别名 `multi_shot`
`multi_prompt`	array	条件必填	多镜头描述，单任务最多 5 段
`kling_elements`	array	否	`kling-v3` 标准路由元素引用，配合提示词中的 `@element_name` 使用
`cfg_scale`	number	否	引导强度
`camera_control`	object	否	镜头控制参数
`callback_url`	string	否	回调地址
`external_task_id`	string	否	业务侧自定义任务 ID

请求示例

curl -X POST https://api.crazyrouter.com/kling/v1/videos/text2video \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model_name": "kling-v2-5-turbo",
    "prompt": "一只猫咪在花园里追蝴蝶，阳光明媚，电影级画质",
    "negative_prompt": "模糊, 低质量, 变形",
    "duration": "5",
    "aspect_ratio": "16:9",
    "mode": "std"
  }'

import requests

response = requests.post(
    "https://api.crazyrouter.com/kling/v1/videos/text2video",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_API_KEY"
    },
    json={
        "model_name": "kling-v2-5-turbo",
        "prompt": "一只猫咪在花园里追蝴蝶，阳光明媚",
        "duration": "5",
        "aspect_ratio": "16:9",
        "mode": "std"
    }
)

print(response.json())

提交成功响应示例

{
  "code": "success",
  "message": "",
  "data": {
    "id": "866168216002236456",
    "task_id": "866168216002236456",
    "model": "kling-v2-5-turbo",
    "status": "queued"
  }
}

图生视频参数

参数	类型	必填	说明
`model_name`	string	是	标准 Kling 视频模型
`image_urls`	array[string]	推荐	官方首帧 / 首尾帧输入；长度 `1` 表示首帧，长度 `2` 表示首尾帧
`image`	string	兼容	兼容别名，等价于 `image_urls[0]`
`prompt`	string	否	动作或镜头描述
`image_tail`	string	兼容	兼容别名，等价于 `image_urls[1]`
`negative_prompt`	string	否	负面提示词
`duration`	string/integer	否	常用 `5` 或 `10`
`aspect_ratio`	string	否	输出比例
`mode`	string	否	生成模式
`sound`	string / boolean	否	推荐使用官方值 `on` / `off`
`multi_shots`	boolean	否	官方多镜头开关；兼容别名 `multi_shot`
`multi_prompt`	array	条件必填	多镜头描述
`kling_elements`	array	否	`kling-v3` 标准路由元素引用
`cfg_scale`	number	否	引导强度
`camera_control`	object	否	镜头控制参数
`callback_url`	string	否	回调地址
`external_task_id`	string	否	业务侧自定义任务 ID

图生视频示例

cURL

curl -X POST https://api.crazyrouter.com/kling/v1/videos/image2video \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model_name": "kling-v3",
    "prompt": "图片中的人物开始微笑并缓缓转头",
    "image": "https://example.com/portrait.jpg",
    "duration": "5",
    "mode": "std"
  }'

官方优先字段是 image_urls。image + image_tail 仍可继续使用，会被当作首帧 / 尾帧兼容别名。视频任务是异步的，请通过任务查询获取终态结果。

本地参考图上传后生成视频

如果参考图在本地，先使用临时图床获取公网 URL，再传给 Kling。临时图片默认保存 72 小时，存储期内不单独按天收费。

cURL

UPLOAD_RESPONSE=$(curl -sS -X POST https://api.crazyrouter.com/v1/files/uploads \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@./portrait.png" \
  -F "purpose=model_input")

IMAGE_URL=$(python -c "import json,sys; print(json.load(sys.stdin)['url'])" <<< "$UPLOAD_RESPONSE")

curl -X POST https://api.crazyrouter.com/kling/v1/videos/image2video \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "{
    \"model_name\": \"kling-v3\",
    \"prompt\": \"图片中的人物缓缓转头并微笑，镜头轻微推进，电影级光影\",
    \"image_urls\": [\"$IMAGE_URL\"],
    \"duration\": \"5\",
    \"mode\": \"std\"
  }"

参考图生视频参数

POST /kling/v1/videos/multi-image2video

该路径对应标准 Kling 官方 Reference 能力。它和 image2video 不同，不使用 image / image_tail，而是使用官方 image_list 作为参考素材输入。

参数	类型	必填	说明
`model_name`	string	是	标准 Kling 视频模型
`prompt`	string	是	参考图一致性与动作描述
`image_list`	array	是	官方参考图列表
`negative_prompt`	string	否	负面提示词
`duration`	string/integer	否	常用 `5` 或 `10`
`aspect_ratio`	string	否	输出比例
`mode`	string	否	生成模式
`sound`	string / boolean	否	推荐使用官方值 `on` / `off`
`multi_shots`	boolean	否	官方多镜头开关；兼容别名 `multi_shot`
`multi_prompt`	array	条件必填	多镜头描述
`cfg_scale`	number	否	引导强度
`camera_control`	object	否	镜头控制参数
`callback_url`	string	否	回调地址
`external_task_id`	string	否	业务侧自定义任务 ID

参考图生视频示例

cURL

curl -X POST https://api.crazyrouter.com/kling/v1/videos/multi-image2video \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model_name": "kling-v3",
    "prompt": "保持同一只柴犬的形象，在草地上向前奔跑",
    "duration": "5",
    "aspect_ratio": "16:9",
    "mode": "pro",
    "image_list": [
      {
        "image_id": 1,
        "image_url": "https://example.com/reference-1.png"
      },
      {
        "image_id": 2,
        "image_url": "https://example.com/reference-2.png"
      }
    ]
  }'

multi-image2video 是标准 Kling 族的参考图能力入口；如果你的输入是首帧或首尾帧，请继续使用 image2video。查询该任务请使用 GET /kling/v1/videos/multi-image2video/{task_id}。

Kling Omni 视频

POST /kling/v1/videos/omni-video

当前公开模型

kling-v3

请求参数

参数	类型	必填	说明
`model_name`	string	是	仅支持 `kling-v3`
`prompt`	string	是	官方 Omni 提示词，可引用 `image_list`、`element_list`、`video_list`、`voice_list` 中的对象
`sound`	string	否	官方值使用 `on` / `off`
`duration`	string/integer	否	常用 `5`，具体上限以对应模型官方文档为准
`aspect_ratio`	string	否	如 `16:9`、`9:16`、`1:1`
`mode`	string	否	生成模式，如 `std`、`pro`
`multi_shots`	boolean	否	官方多镜头开关；兼容别名 `multi_shot`
`multi_prompt`	array	条件必填	多镜头描述
`image_list`	array	否	官方图片参考列表
`element_list`	array	否	官方元素参考列表
`video_list`	array	否	官方视频参考列表
`voice_list`	array	否	官方声音参考列表
`callback_url`	string	否	回调地址
`external_task_id`	string	否	业务侧自定义任务 ID

Omni 请求示例

cURL

curl -X POST https://api.crazyrouter.com/kling/v1/videos/omni-video \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model_name": "kling-v3",
    "prompt": "<<<image_1>>> 在雨夜巷子里向镜头走来",
    "sound": "on",
    "duration": "5",
    "aspect_ratio": "16:9",
    "mode": "pro",
    "image_list": [
      {
        "image_id": 1,
        "image_url": "https://example.com/reference.png"
      }
    ]
  }'

Omni 路由推荐使用官方 element_list，同时兼容 kling_elements 别名。若要查询任务，请使用与提交路径同族的 GET /kling/v1/videos/omni-video/{task_id}。

Chat - OpenAI

Chat - Claude

Chat - Gemini

Chat - Responses API

图像生成

视频生成

音频

嵌入 & 重排序

其他 API

参考

Kling 视频生成

Kling 视频生成

首批 5 模型与能力

标准 Kling 视频

当前推荐模型

文生视频参数

请求示例

提交成功响应示例

图生视频参数

图生视频示例

本地参考图上传后生成视频

参考图生视频参数

参考图生视频示例

Kling Omni 视频

当前公开模型

请求参数

Omni 请求示例

​Kling 视频生成

​首批 5 模型与能力

​标准 Kling 视频

​当前推荐模型

​文生视频参数

​请求示例

​提交成功响应示例

​图生视频参数

​图生视频示例

​本地参考图上传后生成视频

​参考图生视频参数

​参考图生视频示例

​Kling Omni 视频

​当前公开模型

​请求参数

​Omni 请求示例

Kling 视频生成

首批 5 模型与能力

标准 Kling 视频

当前推荐模型

文生视频参数

请求示例

提交成功响应示例

图生视频参数

图生视频示例

本地参考图上传后生成视频

参考图生视频参数

参考图生视频示例

Kling Omni 视频

当前公开模型

请求参数

Omni 请求示例