主题模式
可灵视频生成接口文档(旧版)
本文保留旧版视频生成接口及既有模型说明。
Kling-4.0与Kling-4.0-Flash请使用 新版接口文档;主体与音色接口见 主体与音色管理。可灵官方文档(可参考):https://klingai.com/document-api/api/video/3-0-omni/text-to-video
API 总览
统一请求头
| 字段 | 值 | 描述 |
|---|---|---|
| Content-Type | application/json | 数据交换格式 |
| Authorization | Bearer {api_key} | 鉴权信息 |
核心说明
统一采用
{BASE_URL}/api/v1/multimodal/kling/videos/...接口路径承载可灵视频能力。当前视频任务长期可查,但 URL 有有效期,查询到视频结果后请及时转存。
BASE_URL为https://aiping.cn
扣费字段说明
可灵上游计费已从「资源包积分扣减」切换为「账户余额额度抵扣」。查询任务返回中与扣费相关的字段如下:
| 字段 | 说明 |
|---|---|
final_unit_deduction | 积分体系字段,任务最终扣减积分数值。存量资源包未耗尽期间仍可能返回 |
final_balance_deduction | 额度体系字段,额度扣减信息 |
final_balance_deduction.quota | 额度扣减折扣价。通过本平台调用时,该值与刊例价一致 |
final_balance_deduction.list_price | 额度扣减刊例价(原价) |
过渡期两套字段并存,请以接口实际返回为准。
视频能力接口
1) 文生视频(Text2Video)
| 功能 | 方法 | 路径 |
|---|---|---|
| 创建 | POST | /api/v1/multimodal/kling/videos/text2video |
| 单任务查询 | GET | /api/v1/multimodal/kling/videos/text2video/{task_id} |
| 列表查询 | GET | /api/v1/multimodal/kling/videos/text2video?pageNum=1&pageSize=30 |
2) 图生视频(Image2Video)
| 功能 | 方法 | 路径 |
|---|---|---|
| 创建 | POST | /api/v1/multimodal/kling/videos/image2video |
| 单任务查询 | GET | /api/v1/multimodal/kling/videos/image2video/{task_id} |
| 列表查询 | GET | /api/v1/multimodal/kling/videos/image2video?pageNum=1&pageSize=30 |
3) Omni / 多镜头(Omni Video)
| 功能 | 方法 | 路径 |
|---|---|---|
| 创建 | POST | /api/v1/multimodal/kling/videos/omni-video |
| 单任务查询 | GET | /api/v1/multimodal/kling/videos/omni-video/{task_id} |
| 列表查询 | GET | /api/v1/multimodal/kling/videos/omni-video?pageNum=1&pageSize=30 |
4) 多图参考生视频(Multi-Image2Video)
| 功能 | 方法 | 路径 |
|---|---|---|
| 创建 | POST | /api/v1/multimodal/kling/videos/multi-image2video |
| 单任务查询 | GET | /api/v1/multimodal/kling/videos/multi-image2video/{task_id} |
| 列表查询 | GET | /api/v1/multimodal/kling/videos/multi-image2video?pageNum=1&pageSize=30 |
5) 动作控制(Motion Control)
| 功能 | 方法 | 路径 |
|---|---|---|
| 创建 | POST | /api/v1/multimodal/kling/videos/motion-control |
| 单任务查询 | GET | /api/v1/multimodal/kling/videos/motion-control/{task_id} |
| 列表查询 | GET | /api/v1/multimodal/kling/videos/motion-control?pageNum=1&pageSize=30 |
6) 视频延长(Video Extend)
| 功能 | 方法 | 路径 |
|---|---|---|
| 创建 | POST | /api/v1/multimodal/kling/videos/video-extend |
| 单任务查询 | GET | /api/v1/multimodal/kling/videos/video-extend/{task_id} |
| 列表查询 | GET | /api/v1/multimodal/kling/videos/video-extend?pageNum=1&pageSize=30 |
返回结构(总览)
创建任务返回(示例)
JSON
{
"code": 0,
"message": "string",
"request_id": "string",
"data": {
"task_id": "string",
"task_status": "submitted",
"task_info": {
"external_task_id": "string"
},
"created_at": 1722769557708,
"updated_at": 1722769557708
}
}单任务查询返回(示例)
JSON
{
"code": 0,
"message": "string",
"request_id": "string",
"data": {
"task_id": "string",
"task_status": "succeed",
"task_status_msg": "string",
"task_info": {
"external_task_id": "string"
},
"task_result": {
"videos": [
{
"id": "string",
"url": "string",
"watermark_url": "string",
"duration": "string"
}
]
},
"watermark_info": {
"enabled": true
},
"final_unit_deduction": "string",
"final_balance_deduction": { // 额度扣减信息
"quota": "string", // 额度扣减折扣价
"list_price": "string" // 额度扣减刊例价
},
"created_at": 1722769557708,
"updated_at": 1722769557708
}
}列表查询返回(示例)
JSON
{
"code": 0,
"message": "string",
"request_id": "string",
"data": [
{
"task_id": "string",
"task_status": "succeed",
"task_status_msg": "string",
"task_info": {
"external_task_id": "string"
},
"task_result": {
"videos": [
{
"id": "string",
"url": "string",
"watermark_url": "string",
"duration": "string"
}
]
},
"watermark_info": {
"enabled": true
},
"final_unit_deduction": "string",
"final_balance_deduction": { // 额度扣减信息
"quota": "string", // 额度扣减折扣价
"list_price": "string" // 额度扣减刊例价
},
"created_at": 1722769557708,
"updated_at": 1722769557708
}
]
}文生视频
文生视频用于根据文本提示词生成视频。
创建任务
| 网络协议 | 请求地址 | 请求方法 | 请求格式 | 响应格式 |
|---|---|---|---|---|
| https | /api/v1/multimodal/kling/videos/text2video | POST | application/json | application/json |
请求体参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model_name | string | 否 | Kling-V3 | 推荐使用的模型字段,目前支持Kling-V3,Kling-V2.6,Kling-V1.6 |
model | string | 否 | 无 | 兼容字段,会映射到 model_name |
prompt | string | 否 | 无 | 文本提示词 |
negative_prompt | string | 否 | 空 | 负向提示词 |
multi_shot | boolean | 否 | false | 多镜头开关 |
shot_type | string | 条件必填 | 无 | multi_shot=true 时按上游规则生效 |
multi_prompt | array | 条件必填 | 无 | 多镜头分镜信息 |
sound | string | 否 | off | 是否生成声音 |
cfg_scale | float | 否 | 0.5 | 提示词参考强度,取值范围 [0,1] |
mode | string | 否 | std | 视频模式 |
aspect_ratio | string | 否 | 16:9 | 画面比例 |
seconds | string | 否 | 无 | 兼容时长字段 |
duration | string | 否 | 无 | 时长字段 |
camera_control | object | 否 | 空 | 运镜控制 |
watermark_info | object | 否 | 空 | 是否同时生成含水印的结果 |
callback_url | string | 否 | 空 | 回调地址 |
external_task_id | string | 否 | 空 | 自定义任务 ID |
请求示例
Shell
curl --request POST \
--url https://aiping.cn/api/v1/multimodal/kling/videos/text2video \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: application/json' \
--data '{
"model_name": "Kling-V2.6",
"prompt": "一只可爱的小兔子,戴着眼镜,坐在桌边,看报纸,桌上放着一杯卡布奇诺",
"negative_prompt": "",
"duration": "5",
"mode": "pro",
"sound": "on",
"aspect_ratio": "1:1",
"callback_url": "",
"external_task_id": ""
}'创建返回
JSON
{
"code": 0, // 错误码;具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID,系统生成,用于跟踪请求、排查问题
"data": {
"task_id": "string", // 任务ID,系统生成
"task_info": { // 任务创建时的参数信息
"external_task_id": "string" // 客户自定义任务ID
},
"task_status": "string", // 任务状态,枚举值:submitted(已提交)、processing(处理中)、succeed(成功)、failed(失败)
"created_at": 1722769557708, // 任务创建时间,Unix时间戳、单位ms
"updated_at": 1722769557708 // 任务更新时间,Unix时间戳、单位ms
}
}查询任务
查询单个
| 网络协议 | 请求地址 | 请求方法 | 请求格式 | 响应格式 |
|---|---|---|---|---|
| https | /api/v1/multimodal/kling/videos/text2video/{task_id} | GET | application/json | application/json |
查询任务返回(单个)
Java
{
"code": 0, // 错误码;具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID,系统生成,用于跟踪请求、排查问题
"data": {
"task_id": "string", // 任务ID,系统生成
"task_status": "string", // 任务状态,枚举值:submitted(已提交)、processing(处理中)、succeed(成功)、failed(失败)
"task_status_msg": "string", // 任务状态信息,当任务失败时展示失败原因(如触发平台的内容风控等)
"task_info": { // 任务创建时的参数信息
"external_task_id": "string" // 客户自定义任务ID
},
"task_result": {
"videos": [
{
"id": "string", // 生成的视频ID;全局唯一
"url": "string", // 生成视频的URL(请注意,为保障信息安全,生成的图片/视频会在30天后被清理,请及时转存)
"watermark_url": "string", // 含水印视频下载URL,防盗链格式
"duration": "string" // 视频总时长,单位s
}
]
},
"watermark_info": {
"enabled": boolean
},
"final_unit_deduction": "string", // 任务最终扣减积分数值
"final_balance_deduction": { // 额度扣减信息
"quota": "string", // 额度扣减折扣价
"list_price": "string" // 额度扣减刊例价
},
"created_at": 1722769557708, // 任务创建时间,Unix时间戳、单位ms
"updated_at": 1722769557708 // 任务更新时间,Unix时间戳、单位ms
}
}查询列表
| 网络协议 | 请求地址 | 请求方法 | 请求格式 | 响应格式 |
|---|---|---|---|---|
| https | /api/v1/multimodal/kling/videos/text2video?pageNum=1&pageSize=30 | GET | application/json | application/json |
查询任务返回(列表)
Java
{
"code": 0, // 错误码;具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID,系统生成,用于跟踪请求、排查问题
"data": [
{
"task_id": "string", // 任务ID,系统生成
"task_status": "string", // 任务状态,枚举值:submitted(已提交)、processing(处理中)、succeed(成功)、failed(失败)
"task_status_msg": "string", // 任务状态信息,当任务失败时展示失败原因(如触发平台的内容风控等)
"task_info": { // 任务创建时的参数信息
"external_task_id": "string" // 客户自定义任务ID
},
"task_result": {
"videos": [
{
"id": "string", // 生成的视频ID;全局唯一
"url": "string", // 生成视频的URL(请注意,为保障信息安全,生成的图片/视频会在30天后被清理,请及时转存)
"watermark_url": "string", // 含水印视频下载URL,防盗链格式
"duration": "string" // 视频总时长,单位s
}
]
},
"watermark_info": {
"enabled": boolean
},
"final_unit_deduction": "string", // 任务最终扣减积分数值
"final_balance_deduction": { // 额度扣减信息
"quota": "string", // 额度扣减折扣价
"list_price": "string" // 额度扣减刊例价
},
"created_at": 1722769557708, // 任务创建时间,Unix时间戳、单位ms
"updated_at": 1722769557708 // 任务更新时间,Unix时间戳、单位ms
}
]
}注意事项
参数与取值以官方文档为准,优先使用
model_name。model仅是兼容写法,不建议作为主文档字段。不同模型在
mode、duration、sound、camera_control上支持范围不同,以官方能力地图为准。
图生视频
图生视频用于根据参考图像(首帧/尾帧)与提示词生成视频。
创建任务
| 网络协议 | 请求地址 | 请求方法 | 请求格式 | 响应格式 |
|---|---|---|---|---|
| https | /api/v1/multimodal/kling/videos/image2video | POST | application/json | application/json |
请求体参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model_name | string | 可选 | Kling-V3 | 推荐模型字段,目前支持Kling-V3,Kling-V2.6,Kling-V1.6 |
model | string | 可选 | 无 | 兼容字段,会映射到 model_name |
image | string | 条件必填 | 无 | 参考图,支持 URL/Base64;与 image_tail 至少二选一 |
image_tail | string | 条件必填 | 无 | 尾帧参考图;与 image 至少二选一 |
multi_shot | boolean | 可选 | false | 是否多镜头;true 时 prompt 失效 |
shot_type | string | 条件必填 | 无 | multi_shot=true 时必填:customize/intelligence |
prompt | string | 条件必填 | 无 | 正向提示词;长度不超过 2500 |
multi_prompt | array | 条件必填 | 无 | multi_shot=true 且 shot_type=customize 时必填 |
negative_prompt | string | 可选 | 空 | 负向提示词,长度不超过 2500 |
element_list | array | 可选 | 空 | 参考主体列表,最多 3 个主体 |
voice_list | array | 可选 | 空 | 音色列表,最多 2 个,和 element_list 互斥 |
sound | string | 可选 | off | 是否生成声音:on/off |
cfg_scale | float | 可选 | 0.5 | 自由度,范围 [0,1](kling-v2.x 不支持) |
mode | string | 可选 | std | 生成模式:std / pro / 4k |
static_mask | string | 可选 | 空 | 静态笔刷 mask 图片 |
dynamic_masks | array | 可选 | 空 | 动态笔刷配置列表(每项含 mask + trajectories) |
camera_control | object | 可选 | 空 | 摄像机运动控制参数 |
aspect_ratio | string | 可选 | 16:9 | 画面比例:16:9 / 9:16 / 1:1 |
seconds | string | 可选 | 无 | 兼容时长字段 |
duration | string | 可选 | 无 | 时长字段 |
watermark_info | object | 可选 | 空 | 水印开关 |
callback_url | string | 可选 | 空 | 回调地址 |
external_task_id | string | 可选 | 空 | 自定义任务 ID |
请求示例
Shell
curl --location --request POST 'https://aiping.cn/api/v1/multimodal/kling/videos/image2video' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: application/json' \
--data-raw '{
"model_name": "Kling-V2.6",
"image": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png",
"image_tail": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png",
"prompt": "镜头拉远,女生微笑",
"negative_prompt": "",
"duration": "5",
"mode": "pro",
"sound": "off",
"callback_url": "",
"external_task_id": ""
}'创建返回
JSON
{
"code": 0, // 错误码;具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID,系统生成,用于跟踪请求、排查问题
"data": {
"task_id": "string", // 任务ID,系统生成
"task_info": { // 任务创建时的参数信息
"external_task_id": "string" // 客户自定义任务ID
},
"task_status": "string", // 任务状态,枚举值:submitted(已提交)、processing(处理中)、succeed(成功)、failed(失败)
"created_at": 1722769557708, // 任务创建时间,Unix时间戳、单位ms
"updated_at": 1722769557708 // 任务更新时间,Unix时间戳、单位ms
}
}查询任务
查询单个
| 网络协议 | 请求地址 | 请求方法 | 请求格式 | 响应格式 |
|---|---|---|---|---|
| https | /api/v1/multimodal/kling/videos/image2video/{task_id} | GET | application/json | application/json |
查询任务返回(单个)
Java
{
"code": 0, // 错误码;具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID,系统生成,用于跟踪请求、排查问题
"data": {
"task_id": "string", // 任务ID,系统生成
"task_status": "string", // 任务状态,枚举值:submitted(已提交)、processing(处理中)、succeed(成功)、failed(失败)
"task_status_msg": "string", // 任务状态信息,当任务失败时展示失败原因(如触发平台的内容风控等)
"watermark_info": {
"enabled": boolean
},
"task_result": {
"videos": [
{
"id": "string", // 生成的视频ID;全局唯一
"url": "string", // 生成视频的URL(请注意,为保障信息安全,生成的图片/视频会在30天后被清理,请及时转存)
"watermark_url": "string", // 含水印视频下载URL,防盗链格式
"duration": "string" // 视频总时长,单位s
}
]
},
"task_info": { // 任务创建时的参数信息
"external_task_id": "string" // 客户自定义任务ID
},
"final_unit_deduction": "string", // 任务最终扣减积分数值
"final_balance_deduction": { // 额度扣减信息
"quota": "string", // 额度扣减折扣价
"list_price": "string" // 额度扣减刊例价
},
"created_at": 1722769557708, // 任务创建时间,Unix时间戳、单位ms
"updated_at": 1722769557708 // 任务更新时间,Unix时间戳、单位ms
}
}查询列表
| 网络协议 | 请求地址 | 请求方法 | 请求格式 | 响应格式 |
|---|---|---|---|---|
| https | /api/v1/multimodal/kling/videos/image2video?pageNum=1&pageSize=30 | GET | application/json | application/json |
查询任务返回(列表)
Java
{
"code": 0, // 错误码;具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID,系统生成,用于跟踪请求、排查问题
"data": [
{
"task_id": "string", // 任务ID,系统生成
"task_status": "string", // 任务状态,枚举值:submitted(已提交)、processing(处理中)、succeed(成功)、failed(失败)
"task_status_msg": "string", // 任务状态信息,当任务失败时展示失败原因(如触发平台的内容风控等)
"task_info": { // 任务创建时的参数信息
"external_task_id": "string" // 客户自定义任务ID
},
"task_result": {
"videos": [
{
"id": "string", // 生成的视频ID;全局唯一
"url": "string", // 生成视频的URL(请注意,为保障信息安全,生成的图片/视频会在30天后被清理,请及时转存)
"watermark_url": "string", // 含水印视频下载URL,防盗链格式
"duration": "string" // 视频总时长,单位s
}
]
},
"watermark_info": {
"enabled": boolean
},
"final_unit_deduction": "string", // 任务最终扣减积分数值
"final_balance_deduction": { // 额度扣减信息
"quota": "string", // 额度扣减折扣价
"list_price": "string" // 额度扣减刊例价
},
"created_at": 1722769557708, // 任务创建时间,Unix时间戳、单位ms
"updated_at": 1722769557708 // 任务更新时间,Unix时间戳、单位ms
}
]
}参数兼容
| 兼容字段 | 行为 |
|---|---|
model | 自动映射到官方字段 model_name |
seconds | 统一视频创建流程可兼容,最终按标准化逻辑处理 |
接口约束
当模型为 Kling-Video-O1 或 Kling-V3-Omni 时,请使用 /api/v1/multimodal/kling/videos/omni-video。
注意事项
参数与取值以官方文档为准。
图生视频涉及较多互斥/组合规则(如
element_list与voice_list、multi_shot条件必填等),请按官方约束组包。
多图参考生视频
创建任务
| 网络协议 | 请求地址 | 请求方法 | 请求格式 | 响应格式 |
|---|---|---|---|---|
| https | /api/v1/multimodal/kling/videos/multi-image2video | POST | application/json | application/json |
请求体参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model_name | string | 否 | Kling-V1.6 | 推荐模型字段,目前支持Kling-V1.6 |
model | string | 否 | 无 | 兼容字段,会映射到 model_name |
image_list | array | 是 | 无 | 参考图片列表(会自动归一化) |
reference_images | array | 否 | 无 | image_list 兼容别名 |
prompt | string | 否 | 空 | 正向提示词 |
negative_prompt | string | 否 | 空 | 负向提示词 |
mode | string | 否 | std | 模式(常见 std / pro) |
seconds | string | 否 | 无 | 兼容时长字段 |
duration | string | 否 | 无 | 时长字段 |
aspect_ratio | string | 否 | 16:9 | 画面比例 |
watermark_info | object | 否 | 空 | 水印开关 |
callback_url | string | 否 | 空 | 回调地址 |
external_task_id | string | 否 | 空 | 自定义任务 ID |
请求示例
Shell
curl --request POST \
--url https://aiping.cn/api/v1/multimodal/kling/videos/multi-image2video \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: application/json' \
--data '{
"model_name": "Kling-V1.6",
"image_list": [
{ "image": "https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dog.png" },
{ "image": "https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dog_cloth.png" }
],
"prompt": "一只白色比熊穿着东北红色花棉袄,舔自己的手",
"negative_prompt": "",
"mode": "pro",
"duration": "5",
"aspect_ratio": "16:9",
"callback_url": "",
"external_task_id": ""
}'创建返回
JSON
{
"code": 0, // 错误码;具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID,系统生成,用于跟踪请求、排查问题
"data": {
"task_id": "string", // 任务ID,系统生成
"task_status": "string", // 任务状态,枚举值:submitted(已提交)、processing(处理中)、succeed(成功)、failed(失败)
"created_at": 1722769557708, // 任务创建时间,Unix时间戳、单位ms
"updated_at": 1722769557708 //任务更新时间,Unix时间戳、单位ms
}
}查询任务
查询单个
| 网络协议 | 请求地址 | 请求方法 | 请求格式 | 响应格式 |
|---|---|---|---|---|
| https | /api/v1/multimodal/kling/videos/multi-image2video/{task_id} | GET | application/json | application/json |
查询任务返回(单个)
Java
{
"code": 0, // 错误码;具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID,系统生成,用于跟踪请求、排查问题
"data": {
"task_id": "string", // 任务ID,系统生成
"task_status": "string", // 任务状态,枚举值:submitted(已提交)、processing(处理中)、succeed(成功)、failed(失败)
"task_status_msg": "string", // 任务状态信息,当任务失败时展示失败原因(如触发平台的内容风控等)
"task_info": { //任务创建时的参数信息
"external_task_id": "string" //客户自定义任务ID
},
"task_result": {
"videos": [
{
"id": "string", // 生成的视频ID;全局唯一
"url": "string", // 生成视频的URL(请注意,为保障信息安全,生成的图片/视频会在30天后被清理,请及时转存)
"watermark_url": "string", // 含水印视频下载URL,防盗链格式
"duration": "string" //视频总时长,单位s
}
]
},
"watermark_info": {
"enabled": boolean
},
"final_unit_deduction": "string", // 任务最终扣减积分数值
"final_balance_deduction": { // 额度扣减信息
"quota": "string", // 额度扣减折扣价
"list_price": "string" // 额度扣减刊例价
},
"created_at": 1722769557708, // 任务创建时间,Unix时间戳、单位ms
"updated_at": 1722769557708 //任务更新时间,Unix时间戳、单位ms
}
}查询列表
| 网络协议 | 请求地址 | 请求方法 | 请求格式 | 响应格式 |
|---|---|---|---|---|
| https | /api/v1/multimodal/kling/videos/multi-image2video?pageNum=1&pageSize=30 | GET | application/json | application/json |
查询参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| task_id | string | 是 | - | 任务 ID(单任务查询时路径参数) |
| pageNum | int | 否 | 1 | 页码,范围 [1, 1000] |
| pageSize | int | 否 | 30 | 每页数据量,范围 [1, 500] |
| provider | string | 否 | - | 指定服务商 |
查询任务返回(列表)
Java
{
"code": 0, // 错误码;具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID,系统生成,用于跟踪请求、排查问题
"data": [
{
"task_id": "string", // 任务ID,系统生成
"task_status": "string", // 任务状态,枚举值:submitted(已提交)、processing(处理中)、succeed(成功)、failed(失败)
"task_status_msg": "string", // 任务状态信息,当任务失败时展示失败原因(如触发平台的内容风控等)
"task_info": { //任务创建时的参数信息
"external_task_id": "string" //客户自定义任务ID
},
"task_result": {
"videos": [
{
"id": "string", // 生成的视频ID;全局唯一
"url": "string", // 生成视频的URL(请注意,为保障信息安全,生成的图片/视频会在30天后被清理,请及时转存)
"watermark_url": "string", // 含水印视频下载URL,防盗链格式
"duration": "string" //视频总时长,单位s
}
]
},
"watermark_info": {
"enabled": boolean
},
"final_unit_deduction": "string", // 任务最终扣减积分数值
"final_balance_deduction": { // 额度扣减信息
"quota": "string", // 额度扣减折扣价
"list_price": "string" // 额度扣减刊例价
},
"created_at": 1722769557708, // 任务创建时间,Unix时间戳、单位ms
"updated_at": 1722769557708 //任务更新时间,Unix时间戳、单位ms
}
]
}注意事项
model是兼容字段,建议优先使用model_name。多图输入建议直接按
{ "image": "..." }结构传参,最稳定。
动作控制
动作控制用于通过参考图像和参考视频生成视频,使生成视频中的人物动作与参考视频一致。
创建动作控制任务
| 网络协议 | 请求地址 | 请求方法 | 请求格式 | 响应格式 |
|---|---|---|---|---|
| https | /api/v1/multimodal/kling/videos/motion-control | POST | application/json | application/json |
请求体参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model_name | string | 可选 | Kling-V2.6 | 推荐模型字段,目前支持Kling-V3,Kling-V2.6 |
model | string | 可选 | 无 | 兼容字段,会映射到 model_name |
prompt | string | 可选 | 空 | 文本提示词,不超过 2500 |
image_url | string | 必填 | 无 | 参考图像(URL/Base64) |
video_url | string | 必填 | 无 | 参考视频链接 |
element_list | array | 可选 | 空 | 主体参考列表(当前最多 1 个主体) |
keep_original_sound | string | 可选 | yes | 是否保留原声:yes/no |
character_orientation | string | 必填 | 无 | 人物朝向:image / video |
mode | string | 必填 | 无 | 生成模式:std / pro |
watermark_info | object | 可选 | 空 | 水印开关,格式:{"enabled": boolean} |
callback_url | string | 可选 | 空 | 回调地址 |
external_task_id | string | 可选 | 空 | 自定义任务 ID |
请求示例
Shell
curl --request POST \
--url https://aiping.cn/api/v1/multimodal/kling/videos/motion-control \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: application/json; charset=utf-8' \
--data-raw '{
"model_name": "Kling-V2.6",
"image_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-3.ng.png",
"prompt": "女孩穿着灰色宽松T恤和牛仔短裤",
"video_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dance.mp4",
"keep_original_sound": "yes",
"character_orientation": "image",
"mode": "pro",
"callback_url": "",
"external_task_id": "xxx"
}'创建返回
JSON
{
"code": 0, // 错误码;具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID,系统生成,用于跟踪请求、排查问题
"data": {
"task_id": "string", // 任务ID,系统生成
"task_info": { //任务创建时的参数信息
"external_task_id": "string" //客户自定义任务ID
},
"task_status": "string", // 任务状态,枚举值:submitted(已提交)、processing(处理中)、succeed(成功)、failed(失败)
"created_at": 1722769557708, // 任务创建时间,Unix时间戳、单位ms
"updated_at": 1722769557708 //任务更新时间,Unix时间戳、单位ms
}
}查询任务
查询单个
| 网络协议 | 请求地址 | 请求方法 | 请求格式 | 响应格式 |
|---|---|---|---|---|
| https | /api/v1/multimodal/kling/videos/motion-control/{task_id} | GET | application/json | application/json |
查询任务返回(单个)
Java
{
"code": 0, // 错误码;具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID,系统生成,用于跟踪请求、排查问题
"data": {
"task_id": "string", // 任务ID,系统生成
"task_status": "string", // 任务状态,枚举值:submitted(已提交)、processing(处理中)、succeed(成功)、failed(失败)
"task_status_msg": "string", // 任务状态信息,当任务失败时展示失败原因(如触发平台的内容风控等)
"task_info": { //任务创建时的参数信息
"external_task_id": "string" //客户自定义任务ID
},
"task_result": {
"videos": [
{
"id": "string", // 生成的视频ID;全局唯一
"url": "string", // 生成视频的URL,防盗链格式(请注意,为保障信息安全,生成的图片/视频会在30天后被清理,请及时转存)
"watermark_url": "string", // 含水印视频下载URL,防盗链格式
"duration": "string" //视频总时长,单位s
}
]
},
"watermark_info": {
"enabled": boolean
},
"final_unit_deduction": "string", // 任务最终扣减积分数值
"final_balance_deduction": { // 额度扣减信息
"quota": "string", // 额度扣减折扣价
"list_price": "string" // 额度扣减刊例价
},
"created_at": 1722769557708, // 任务创建时间,Unix时间戳、单位ms
"updated_at": 1722769557708 //任务更新时间,Unix时间戳、单位ms
}
}查询列表
| 网络协议 | 请求地址 | 请求方法 | 请求格式 | 响应格式 |
|---|---|---|---|---|
| https | /api/v1/multimodal/kling/videos/motion-control?pageNum=1&pageSize=30 | GET | application/json | application/json |
查询任务返回(列表)
Java
{
"code": 0, // 错误码;具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID,系统生成,用于跟踪请求、排查问题
"data": [
{
"task_id": "string", // 任务ID,系统生成
"task_status": "string", // 任务状态,枚举值:submitted(已提交)、processing(处理中)、succeed(成功)、failed(失败)
"task_status_msg": "string", // 任务状态信息,当任务失败时展示失败原因(如触发平台的内容风控等)
"task_info": { //任务创建时的参数信息
"external_task_id": "string" //客户自定义任务ID
},
"task_result": {
"videos": [
{
"id": "string", // 生成的视频ID;全局唯一
"url": "string", // 生成视频的URL,防盗链格式(请注意,为保障信息安全,生成的图片/视频会在30天后被清理,请及时转存)
"watermark_url": "string", // 含水印视频下载URL,防盗链格式
"duration": "string" //视频总时长,单位s
}
]
},
"watermark_info": {
"enabled": boolean
},
"final_unit_deduction": "string", // 任务最终扣减积分数值
"final_balance_deduction": { // 额度扣减信息
"quota": "string", // 额度扣减折扣价
"list_price": "string" // 额度扣减刊例价
},
"created_at": 1722769557708, // 任务创建时间,Unix时间戳、单位ms
"updated_at": 1722769557708 //任务更新时间,Unix时间戳、单位ms
}
]
}参数兼容
| 兼容字段 | 行为 |
|---|---|
action_control | 历史兼容字段;当前路径下会在透传前清理,不作为必填 |
注意事项
建议优先使用
model_name;model为兼容写法。action_control不是当前主参数,仅为历史兼容字段。mode在官方动作控制接口口径下为std/pro,请避免传入不受支持模式。
Omni 视频生成
创建任务
| 网络协议 | 请求地址 | 请求方法 | 请求格式 | 响应格式 |
|---|---|---|---|---|
| https | /api/v1/multimodal/kling/videos/omni-video | POST | application/json | application/json |
请求体参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model_name | string | 否 | 上游默认 | 推荐模型字段,目前支持kling-video-o1 , kling-v3-omni |
model | string | 否 | 无 | 兼容字段,会映射到 model_name |
multi_shot | boolean | 否 | false | 是否多镜头;kling-video-o1 不支持分镜 |
shot_type | string | 条件必填 | 无 | multi_shot=true 时生效 |
prompt | string | 条件必填 | 无 | 提示词(单镜头或智能分镜必填) |
multi_prompt | array | 条件必填 | 无 | multi_shot=true 且 shot_type=customize 时必填 |
image_list | array | 否 | 空 | 参考图列表(可含首尾帧) |
element_list | array | 否 | 空 | 主体参考列表 |
video_list | array | 否 | 空 | 参考视频列表(refer_type=base/feature) |
sound | string | 否 | off | 是否生成声音 |
mode | string | 否 | pro | 模式(std/pro/4k) |
aspect_ratio | string | 否 | 无 | 画幅(16:9/9:16/1:1) |
seconds | string | 否 | 无 | 兼容时长字段 |
duration | string | 否 | 无 | 时长字段 |
watermark_info | object | 否 | 空 | 水印开关 |
callback_url | string | 否 | 空 | 回调地址 |
external_task_id | string | 否 | 空 | 自定义任务 ID |
请求示例
普通参考图:
Shell
curl --request POST \
--url https://aiping.cn/api/v1/multimodal/kling/videos/omni-video \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: application/json' \
--data '{
"model_name": "Kling-Video-O1",
"prompt": "让<<<image_1>>>中的人物向镜头挥手",
"image_list": [
{
"image_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png"
}
],
"duration": "5",
"mode": "pro",
"aspect_ratio": "16:9",
"callback_url": "",
"external_task_id": ""
}'首尾帧:
Shell
curl --location 'https://aiping.cn/api/v1/multimodal/kling/videos/omni-video' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: application/json' \
--data '{
"model_name": "Kling-Video-O1",
"prompt": "视频中的人跳舞",
"image_list": [
{
"image_url": "xxx",
"type": "first_frame"
},
{
"image_url": "xxx",
"type": "end_frame"
}
],
"mode": "pro"
}'创建返回
JSON
{
"code": 0, // 错误码;具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID,系统生成,用于跟踪请求、排查问题
"data": {
"task_id": "string", // 任务ID,系统生成
"task_info": { //任务创建时的参数信息
"external_task_id": "string" //客户自定义任务ID
},
"task_status": "string", // 任务状态,枚举值:submitted(已提交)、processing(处理中)、succeed(成功)、failed(失败)
"created_at": 1722769557708, // 任务创建时间,Unix时间戳、单位ms
"updated_at": 1722769557708 //任务更新时间,Unix时间戳、单位ms
}
}查询任务
查询单个
| 网络协议 | 请求地址 | 请求方法 | 请求格式 | 响应格式 |
|---|---|---|---|---|
| https | /api/v1/multimodal/kling/videos/omni-video/{task_id} | GET | application/json | application/json |
查询任务返回(单个)
Java
{
"code": 0, // 错误码;具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID,系统生成,用于跟踪请求、排查问题
"data": {
"task_id": "string", // 任务ID,系统生成
"task_status": "string", // 任务状态,枚举值:submitted(已提交)、processing(处理中)、succeed(成功)、failed(失败)
"task_status_msg": "string", // 任务状态信息,当任务失败时展示失败原因(如触发平台的内容风控等)
"watermark_info": {
"enabled": boolean
},
"task_result": {
"videos": [
{
"id": "string", // 生成的视频ID;全局唯一
"url": "string", // 生成视频的URL,防盗链格式(请注意,为保障信息安全,生成的图片/视频会在30天后被清理,请及时转存)
"watermark_url": "string", // 含水印视频下载URL,防盗链格式
"duration": "string" //视频总时长,单位s
}
]
},
"task_info": { //任务创建时的参数信息
"external_task_id": "string" //客户自定义任务ID
},
"final_unit_deduction": "string", // 任务最终扣减积分数值
"final_balance_deduction": { // 额度扣减信息
"quota": "string", // 额度扣减折扣价
"list_price": "string" // 额度扣减刊例价
},
"created_at": 1722769557708, // 任务创建时间,Unix时间戳、单位ms
"updated_at": 1722769557708 //任务更新时间,Unix时间戳、单位ms
}
}查询列表
| 网络协议 | 请求地址 | 请求方法 | 请求格式 | 响应格式 |
|---|---|---|---|---|
| https | /api/v1/multimodal/kling/videos/omni-video?pageNum=1&pageSize=30 | GET | application/json | application/json |
查询任务返回(列表)
Java
{
"code": 0, // 错误码;具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID,系统生成,用于跟踪请求、排查问题
"data": [
{
"task_id": "string", // 任务ID,系统生成
"task_status": "string", // 任务状态,枚举值:submitted(已提交)、processing(处理中)、succeed(成功)、failed(失败)
"task_status_msg": "string", // 任务状态信息,当任务失败时展示失败原因(如触发平台的内容风控等)
"task_info": { //任务创建时的参数信息
"external_task_id": "string" //任务ID,客户自定义生成,与task_id两种查询方式二选一
},
"task_result": {
"videos": [
{
"id": "string", // 生成的视频ID;全局唯一
"url": "string", // 生成视频的URL,防盗链格式(请注意,为保障信息安全,生成的图片/视频会在30天后被清理,请及时转存)
"watermark_url": "string", // 含水印视频下载URL,防盗链格式
"duration": "string" //视频总时长,单位s
}
]
},
"watermark_info": {
"enabled": boolean
},
"final_unit_deduction": "string", // 任务最终扣减积分数值
"final_balance_deduction": { // 额度扣减信息
"quota": "string", // 额度扣减折扣价
"list_price": "string" // 额度扣减刊例价
},
"created_at": 1722769557708, // 任务创建时间,Unix时间戳、单位ms
"updated_at": 1722769557708 //任务更新时间,Unix时间戳、单位ms
}
]
}关键约束
多镜头开启时,
shot_type与multi_prompt需满足组合规则。有
video_list且refer_type=base时,上游 Omni 会按“视频编辑/指令变换”场景处理;请求路径仍为/api/v1/multimodal/kling/videos/omni-video,但时长/比例等参数会受到视频编辑场景限制。Kling-Video-O1、Kling-V3-Omni应优先走本路径;若走text2video/image2video路径可能返回422。
视频延长
创建任务
| 网络协议 | 请求地址 | 请求方法 | 请求格式 | 响应格式 |
|---|---|---|---|---|
| https | /api/v1/multimodal/kling/videos/video-extend | POST | application/json | application/json |
请求体参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| video_id | string | 必填 | 无 | 视频ID,支持通过文本、图片和视频延长生成的视频ID(原视频不能超过3分钟),仅支持V1.6模型生成的视频 |
prompt | string | 可选 | 空 | 文本提示词,不超过 2500 |
negative_prompt | string | 可选 | 空 | 负向文本提示词,不超过 2500 |
cfg_scale | float | 可选 | 0.5 | 提示词参考强度,数值越大参考强度越大,取值范围:[0, 1] |
watermark_info | object | 可选 | 空 | 水印开关,格式:{"enabled": boolean} |
callback_url | string | 可选 | 空 | 回调地址 |
external_task_id | string | 可选 | 空 | 自定义任务 ID |
请求示例
Shell
curl --request POST \
--url https://aiping.cn/api/v1/multimodal/kling/videos/video-extend \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: application/json' \
--data '{
"prompt": "出现一只小狗",
"video_id": "743211632612511839",
"negative_prompt": "",
"callback_url": ""
}'创建返回
JSON
{
"code": 0, // 错误码;具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID,系统生成,用于跟踪请求、排查问题
"data": {
"task_id": "string", // 任务ID,系统生成
"task_status": "string", // 任务状态,枚举值:submitted(已提交)、processing(处理中)、succeed(成功)、failed(失败)
"task_info":{ //任务创建时的参数信息
"external_task_id": "string"//客户自定义任务ID
},
"created_at": 1722769557708, // 任务创建时间,Unix时间戳、单位ms
"updated_at": 1722769557708 //任务更新时间,Unix时间戳、单位ms
}
}查询任务
查询单个
| 网络协议 | 请求地址 | 请求方法 | 请求格式 | 响应格式 |
|---|---|---|---|---|
| https | /api/v1/multimodal/kling/videos/video-extend/{task_id} | GET | application/json | application/json |
查询任务返回(单个)
Java
{
"code": 0, // 错误码;具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID,系统生成,用于跟踪请求、排查问题
"data": {
"task_id": "string", // 任务ID,系统生成
"task_status": "string", // 任务状态,枚举值:submitted(已提交)、processing(处理中)、succeed(成功)、failed(失败)
"task_status_msg": "string", // 任务状态信息,当任务失败时展示失败原因(如触发平台的内容风控等)
"task_info": { //任务创建时的参数信息
"parent_video": {
"id": "string", //续写前的视频ID;全局唯一
"url": "string", //续写前视频的URL(请注意,为保障信息安全,生成的图片/视频会在30天后被清理,请及时转存)
"duration": "string" //续写前的视频总时长,单位s
},
"external_task_id": "string"//客户自定义任务ID
},
"task_result": {
"videos": [ //数组是为了保留扩展性,以防未来要支持n
{
"id": "string", //续写后的完整视频ID;全局唯一
"url": "string", //续写后视频的URL(请注意,为保障信息安全,生成的图片/视频会在30天后被清理,请及时转存)
"watermark_url": "string", // 含水印视频下载URL,防盗链格式
"duration": "string" //视频总时长,单位s(秒)
}
]
},
"watermark_info": {
"enabled": boolean
},
"final_unit_deduction": "string", // 任务最终扣减积分数值
"final_balance_deduction": { // 额度扣减信息
"quota": "string", // 额度扣减折扣价
"list_price": "string" // 额度扣减刊例价
},
"created_at": 1722769557708, // 任务创建时间,Unix时间戳、单位ms
"updated_at": 1722769557708 //任务更新时间,Unix时间戳、单位ms
}
}查询列表
| 网络协议 | 请求地址 | 请求方法 | 请求格式 | 响应格式 |
|---|---|---|---|---|
| https | /api/v1/multimodal/kling/videos/video-extend?pageNum=1&pageSize=30 | GET | application/json | application/json |
查询任务返回(列表)
Java
{
"code": 0, // 错误码;具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID,系统生成,用于跟踪请求、排查问题
"data": [
{
"task_id": "string", // 任务ID,系统生成
"task_status": "string", // 任务状态,枚举值:submitted(已提交)、processing(处理中)、succeed(成功)、failed(失败)
"task_status_msg": "string", // 任务状态信息,当任务失败时展示失败原因(如触发平台的内容风控等)
"task_info": { //任务创建时的参数信息
"parent_video": {
"id": "string", //续写前的视频ID;全局唯一
"url": "string", //续写前视频的URL(请注意,为保障信息安全,生成的图片/视频会在30天后被清理,请及时转存)
"duration": "string" //续写前的视频总时长,单位s
},
"external_task_id": "string"//客户自定义任务ID
},
"task_result": {
"videos": [ //数组是为了保留扩展性,以防未来要支持n
{
"id": "string", //续写后的完整视频ID;全局唯一
"url": "string", //续写后视频的URL(请注意,为保障信息安全,生成的图片/视频会在30天后被清理,请及时转存)
"watermark_url": "string", // 含水印视频下载URL,防盗链格式
"duration": "string" //视频总时长,单位s(秒)
}
]
},
"watermark_info": {
"enabled": boolean
},
"final_unit_deduction": "string", // 任务最终扣减积分数值
"final_balance_deduction": { // 额度扣减信息
"quota": "string", // 额度扣减折扣价
"list_price": "string" // 额度扣减刊例价
},
"created_at": 1722769557708, // 任务创建时间,Unix时间戳、单位ms
"updated_at": 1722769557708 //任务更新时间,Unix时间戳、单位ms
}
]
}