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

注:指定的可灵图生视频对接文档地址https://best-gpt.apifox.cn/356374644e0 存在网页解析失败问题,图生视频相关能力可参考6AI平台新增的/kling/v1/videos/multi-image2video接口,核心配置规则与文生视频保持一致,本文重点讲解可灵视频API通用对接配置及文生视频实现,图生视频可参考同规则适配。

一、对接前置准备

  1. 从6AI平台获取专属API Key,作为接口调用的身份鉴权凭证;
  2. 确认6AI平台可灵模型支持版本:kling-v1、kling-v1-5、kling-v1-6、kling-v2-5-turbo(推荐使用kling-v2-5-turbo,6AI已同步上线kling-video-v2-5-turbo专属模型);
  3. 开发环境支持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 参数字段约束

  1. prompt/negative_prompt需控制字符数,超出最大限制会导致请求失败;
  2. cfg_scale仅支持0-1的数值类型,非数值或超出范围会触发参数校验错误;
  3. 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 开发语言适配说明

所有开发语言需满足:

  1. 发起HTTPS POST请求,禁用SSL证书校验忽略(生产环境建议开启校验);
  2. 请求头严格按2.2节配置,API Key替换为实际值;
  3. 请求体为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传入),其余鉴权方式、请求头、模型指定、视频时长/比例等参数与文生视频完全相同。

七、常见问题排查

  1. 鉴权失败:检查Authorization格式是否为Bearer + 空格 + API Key,确认API Key为6AI平台有效凭证;
  2. 参数校验失败:检查prompt/negative_prompt字符数是否超限,cfg_scale是否在0-1范围内,duration是否为5/10;
  3. 任务提交失败:确认model_name为可灵官方支持版本,避免拼写错误(如kling-v2-5-turbo而非kling-v2.5-turbo);
  4. 网页解析失败:原指定的图生视频文档地址暂无法解析,需以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。

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐