# 可灵(Kling)视频API在6AI平台的对接配置教程
本文主要介绍基于6AI中转平台(https://api.6ai.chat)实现可灵(Kling)文生视频、图生视频能力的对接配置方法,包含鉴权配置、接口请求参数、调用示例及响应解析等核心技术内容,6AI平台已实现可灵全模型官方企业级直连,对接时仅需替换域名与API Key,核心参数与可灵官方保持一致。
注:指定的可灵图生视频对接文档地址https://best-gpt.apifox.cn/356374644e0 存在网页解析失败问题,图生视频相关能力可参考6AI平台新增的
/kling/v1/videos/multi-image2video接口,核心配置规则与文生视频保持一致,本文重点讲解可灵视频API通用对接配置及文生视频实现,图生视频可参考同规则适配。
一、对接前置准备
- 从6AI平台获取专属API Key,作为接口调用的身份鉴权凭证;
- 确认6AI平台可灵模型支持版本:kling-v1、kling-v1-5、kling-v1-6、kling-v2-5-turbo(推荐使用kling-v2-5-turbo,6AI已同步上线kling-video-v2-5-turbo专属模型);
- 开发环境支持HTTP/HTTPS POST请求,可解析JSON格式的请求与响应数据。
二、核心接口基础配置
2.1 接口域名与请求路径
6AI平台可灵视频API统一请求域名:https://api.6ai.chat
- 文生视频核心接口:
/kling/v1/videos/text2video - 多图参考生视频接口(6AI新增):
/kling/v1/videos/multi-image2video
请求方式:POST
数据格式:application/json
2.2 请求头(Header)配置
请求头为必选配置,缺少或格式错误会直接导致鉴权失败,核心配置项如下,需严格遵循格式要求:
| 配置项 | 类型 | 必填 | 取值格式 | 功能说明 |
|---|---|---|---|---|
| Authorization | string | 是 | Bearer {6AI平台API Key} | 接口身份鉴权,验证请求合法性 |
| Content-Type | string | 是 | application/json | 声明请求体为JSON格式 |
| Accept | string | 是 | application/json | 声明期望响应为JSON格式 |
配置示例:
Authorization: Bearer 6AI_API_KEY_HERE
Content-Type: application/json
Accept: application/json
三、请求体(Body)参数配置
请求体为JSON格式,包含可灵视频生成的核心参数,部分参数为可选,未指定时将按平台智能匹配规则执行,所有参数需遵循字符数、取值范围约束,核心参数说明如下:
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 | 生成视频时长,单位为秒,仅支持5秒或10秒两种规格 |
3.2 通用可选参数
| 参数名 | 类型 | 取值范围/可选值 | 功能说明 |
|---|---|---|---|
| negative_prompt | string | 最大200字符 | 负向提示词,描述视频中需排除的元素,如模糊、低画质、多余人物等 |
| cfg_scale | number | 0-1 | 生成自由度,值越大,视频内容与prompt相关性越强,建议取值0.7-0.9 |
| mode | string | std(高性能)/pro(高表现) | 生成模式,pro模式画质与细节更优,std模式生成速度更快 |
| aspect_ratio | string | 16:9/9:16/1:1 | 视频画面纵横比,分别对应横屏、竖屏、正方形,未指定时默认16:9 |
| camera_control | object | 包含type和config子参数 | 摄像机运动控制,type为控制类型,config包含6个运动控制参数,未指定则智能匹配 |
| callback_url | string | 有效可访问URL | 任务状态回调地址,平台将实时推送视频生成进度、结果至该地址 |
3.3 参数字段约束
- prompt/negative_prompt需控制字符数,超出最大限制会导致请求失败;
- cfg_scale仅支持0-1的数值类型,非数值或超出范围会触发参数校验错误;
- camera_control为嵌套对象,若指定则type和config子参数为必选,需遵循可灵官方摄像机控制协议规范。
3.4 极简请求体示例(核心参数)
{
"model_name": "kling-v2-5-turbo",
"prompt": "春日草原上的骏马奔跑,蓝天白云,青草随风摆动,4K高清,慢动作",
"duration": 10,
"aspect_ratio": "16:9",
"cfg_scale": 0.8
}
四、接口调用示例
以下提供cURL命令行调用示例,适配6AI平台可灵文生视频接口,其他开发语言(Python/Java/Go等)可按相同请求头、请求体规则实现。
4.1 cURL调用示例
curl --location -g --request POST 'https://api.6ai.chat/kling/v1/videos/text2video' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer 你的6AI_API_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证书校验忽略(生产环境建议开启校验);
- 请求头严格按2.2节配置,API Key替换为实际值;
- 请求体为UTF-8编码的JSON字符串,避免特殊字符转义错误。
五、响应结果解析
可灵视频API为异步任务模式,请求提交成功后将立即返回任务信息,视频生成完成后可通过task_id查询结果,或通过callback_url接收实时回调,响应体为标准JSON格式,核心字段说明如下:
5.1 响应通用字段
| 字段名 | 类型 | 功能说明 |
|---|---|---|
| code | integer | 响应状态码,0表示请求提交成功,非0为失败(需参考message提示排查) |
| message | string | 响应信息,SUCCEED表示成功,其他值为具体失败原因 |
| request_id | string | 6AI平台请求唯一标识,用于问题排查 |
| data | object | 任务核心数据,包含task_id、任务状态等 |
5.2 data嵌套字段
| 字段名 | 类型 | 功能说明 |
|---|---|---|
| task_id | string | 可灵视频生成任务唯一ID,用于查询任务进度和结果 |
| task_status | string | 任务状态,submitted表示已提交,processing表示生成中,finished表示完成 |
| task_info | object | 任务附加信息,生成中为空,完成后包含视频地址、视频大小等 |
| created_at | integer | 任务创建时间戳(毫秒) |
| updated_at | integer | 任务最后更新时间戳(毫秒) |
5.3 成功响应示例
{
"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
}
}
六、图生视频接口适配
6AI平台已新增可灵多图参考生视频接口/kling/v1/videos/multi-image2video,该接口核心配置与文生视频保持一致,仅需在请求体中新增图片参考相关参数(需遵循6AI平台图片参数规范,支持多图URL传入),其余鉴权方式、请求头、模型指定、视频时长/比例等参数与文生视频完全相同。
七、常见问题排查
- 鉴权失败:检查Authorization格式是否为
Bearer + 空格 + API Key,确认API Key为6AI平台有效凭证; - 参数校验失败:检查prompt/negative_prompt字符数是否超限,cfg_scale是否在0-1范围内,duration是否为5/10;
- 任务提交失败:确认model_name为可灵官方支持版本,避免拼写错误(如kling-v2-5-turbo而非kling-v2.5-turbo);
- 网页解析失败:原指定的图生视频文档地址暂无法解析,需以6AI平台新增的
multi-image2video接口为准,或联系6AI技术支持获取最新文档。
八、技术支持
若对接过程中遇到参数配置、接口调用等问题,可通过6AI平台官方技术支持渠道反馈:
- 客服邮箱:461896658@qq.com(备注“6AI-可灵视频对接”)
- 在线支持:工作日10:00-22:00提供专人技术对接
注意:6AI平台可灵模型通道为官方企业级直连,所有参数与可灵官方API保持一致,若需更详细的摄像机控制、图生视频参数规范,可参考可灵官方开发文档:https://app.klingai.com/cn/dev/document-api/apiReference/updateNotice。
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。
更多推荐


所有评论(0)