可灵（Kling）视频 API 在 111API 平台的对接配置教程

本文主要介绍基于 **111API 中转平台（https://111api.chat/）** 实现可灵（Kling）文生视频、图生视频能力的对接配置方法，包含鉴权配置、接口请求参数、调用示例及响应解析等核心技术内容。111API 平台已实现可灵全模型官方企业级直连，对接时仅需替换域名与 API Key，核心参数与可灵官方保持一致。

---

一、对接前置准备

1. 从 111API 平台获取专属API Key，作为接口调用的身份鉴权凭证；
2. 确认 111API 平台可灵模型支持版本：kling-v1、kling-v1-5、kling-v1-6、kling-v2-5-turbo（推荐使用kling-v2-5-turbo）；
3. 开发环境支持HTTP/HTTPS POST请求，可解析 JSON 格式的请求与响应数据。

---

二、核心接口基础配置

2.1 接口域名与请求路径

• 111API 平台可灵视频 API 统一请求域名：https://111api.chat
• 文生视频核心接口：/kling/v1/videos/text2video
• 多图参考生视频接口：/kling/v1/videos/multi-image2video
• 请求方式：POST
• 数据格式：application/json

2.2 请求头（Header）配置

请求头为必选配置，缺少或格式错误会直接导致鉴权失败，核心配置项如下：

表格

配置项	类型	必填	取值格式	功能说明
Authorization	string	是	Bearer {111API 平台 API Key}	接口身份鉴权
Content-Type	string	是	application/json	声明请求体为 JSON 格式
Accept	string	是	application/json	声明期望响应为 JSON 格式

配置示例：

plaintext

Authorization: Bearer 111API_KEY_HERE
Content-Type: application/json
Accept: application/json

---

三、请求体（Body）参数配置

3.1 通用必选参数

表格

参数名	类型	取值范围 / 可选值	功能说明
model_name	string	kling-v1/1-5/1-6/v2-5-turbo	指定可灵模型版本，推荐 kling-v2-5-turbo
prompt	string	最大 500 字符	正向提示词，描述视频生成内容
duration	number	5/10	生成视频时长，单位秒

3.2 通用可选参数

表格

参数名	类型	取值范围 / 可选值	功能说明
negative_prompt	string	最大 200 字符	负向提示词，排除不良元素
cfg_scale	number	0-1	生成自由度，建议 0.7-0.9
mode	string	std/pro	std 速度快，pro 画质优
aspect_ratio	string	16:9/9:16/1:1	视频画面比例
camera_control	object	含 type 与 config	摄像机运动控制
callback_url	string	有效 URL	任务状态回调地址

3.3 极简请求体示例

json

{
  "model_name": "kling-v2-5-turbo",
  "prompt": "春日草原上的骏马奔跑，蓝天白云，青草随风摆动，4K高清，慢动作",
  "duration": 10,
  "aspect_ratio": "16:9",
  "cfg_scale": 0.8
}

---

四、接口调用示例

4.1 cURL 调用示例

bash

运行

curl --location -g --request POST 'https://111api.chat/kling/v1/videos/text2video' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer 你的111API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model_name": "kling-v2-5-turbo",
  "prompt": "海滩上的日落场景，海浪拍打着沙滩，海鸥飞过，暖色调，氛围感拉满",
  "negative_prompt": "模糊、低画质、人物、垃圾",
  "cfg_scale": 0.85,
  "mode": "pro",
  "aspect_ratio": "16:9",
  "duration": 10
}'

4.2 开发语言适配说明

所有语言需遵循：

• 发起HTTPS POST请求，生产环境开启 SSL 校验；
• 请求头严格按上述配置，API Key 替换为实际值；
• 请求体为UTF-8 JSON，避免转义错误。

---

五、响应结果解析

可灵视频 API 为异步任务模式，提交后返回任务 ID，可轮询或回调获取结果。

5.1 响应通用字段

表格

字段名	类型	功能说明
code	integer	0 = 成功，非 0 = 失败
message	string	响应信息
request_id	string	请求唯一标识
data	object	任务核心数据

5.2 data 嵌套字段

表格

字段名	类型	功能说明
task_id	string	任务唯一 ID
task_status	string	submitted/processing/finished
task_info	object	完成后含视频地址、大小等
created_at	integer	创建时间戳
updated_at	integer	更新时间戳

5.3 成功响应示例

json

{
    "code": 0,
    "message": "SUCCEED",
    "request_id": "795f5ea4-7746-4e3a-a184-75d44240f87f",
    "data": {
        "task_id": "814237883686625347",
        "task_status": "submitted",
        "task_info": {},
        "created_at": 1762157958060,
        "updated_at": 1762157958060
    }
}

---

六、图生视频接口适配

111API 平台可灵多图参考生视频接口：/kling/v1/videos/multi-image2video

• 鉴权、请求头、模型、时长、比例等参数与文生视频完全一致；
• 仅需在请求体中新增图片 URL相关参数，遵循平台规范传入。

---

七、常见问题排查

1. 鉴权失败：检查Bearer + 空格 + API Key格式，确认 API Key 有效；
2. 参数校验失败：prompt 字符数、cfg_scale 范围、duration 是否为 5/10；
3. 任务提交失败：model_name 拼写正确，使用kling-v2-5-turbo；
4. 调用异常：检查域名是否为https://111api.chat，网络可访问。

---

八、技术支持

对接过程中遇到参数配置、接口调用问题，可通过 111API 平台官方渠道反馈。

说明：111API 平台可灵模型通道为官方企业级直连，参数与可灵官方 API 保持一致，高级控制可参考官方文档。