主题模式
可灵 AI 多图参考生视频 API 文档
官方文档入口（仅参考）：
创建任务
| 网络协议 | 请求地址 | 请求方法 | 请求格式 | 响应格式 |
|---|---|---|---|---|
| https | /v1/videos/kling/multi-image2video | POST | application/json | application/json |
请求头
| 字段 | 值 | 描述 |
|---|---|---|
| Content-Type | application/json | 数据交换格式 |
| Authorization | Bearer | 鉴权信息 |
请求体参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model_name | string | 否 | Kling-V2.6 | 推荐模型字段，目前支持Kling-V3，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 |
image_list
参考图片列表，必填。最多支持 4 张图片。
用 key:value 承载，格式如下：
json
{
"image_list": [
{ "image": "https://example.com/image-1.png" },
{ "image": "https://example.com/image-2.png" }
]
}子参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
image | string | 是 | 图片 URL 或 Base64 字符串 |
图片要求
- API 端无裁剪逻辑，请直接上传已选主体后的图片。
- 支持传入图片 URL 或 Base64 编码。
- 使用 Base64 时不要添加
data:image/png;base64,等前缀，直接传 Base64 字符串。 - 图片格式支持
.jpg/.jpeg/.png。 - 图片文件大小不能超过
10MB。 - 图片宽高尺寸不小于
300px。 - 图片宽高比介于
1:2.5 ~ 2.5:1。
image_list 元素兼容
支持以下输入并会归一化：
- 字符串：URL/Base64
- 对象：
image/image_url/url/base64
归一化后透传格式：
json
"image_list": [
{ "image": "..." }
]prompt
正向文本提示词，必填。
- 不能超过 2500 个字符。
- 建议明确描述各参考图片中的主体、动作和场景关系。
negative_prompt
负向文本提示词。
- 可选参数。
- 不能超过 2500 个字符。
mode
生成视频的模式。
| 取值 | 说明 |
|---|---|
std | 标准模式，基础模式，性价比高 |
pro | 专家模式，高品质模式，生成视频质量更佳 |
默认值为 std。不同模型版本、视频模式支持范围不同，具体以服务商能力为准。
duration
生成视频时长，单位为秒。
| 取值 |
|---|
5 |
10 |
默认值为 5。不同模型版本、视频模式支持范围不同，具体以服务商能力为准。
aspect_ratio
生成视频画面纵横比。
| 取值 |
|---|
16:9 |
9:16 |
1:1 |
默认值为 16:9。
watermark_info
是否同时生成含水印的结果。
json
{
"watermark_info": {
"enabled": false
}
}| 子参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
enabled | boolean | 是 | true 表示生成含水印结果，false 表示不生成含水印结果 |
暂不支持自定义水印。
callback_url
本次任务结果回调通知地址。如果配置，服务端会在任务状态发生变更时主动通知。
external_task_id
自定义任务 ID。传入后不会覆盖系统生成的任务 ID，但支持通过该 ID 查询任务。单用户下需保证唯一。
查询任务
查询单个
| 网络协议 | 请求地址 | 请求方法 | 请求格式 | 响应格式 |
|---|---|---|---|---|
| https | /v1/videos/kling/multi-image2video/{task_id} | GET | application/json | application/json |
查询列表
| 网络协议 | 请求地址 | 请求方法 | 请求格式 | 响应格式 |
|---|---|---|---|---|
| https | /v1/videos/kling/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 | 否 | - | 指定服务商 |
请求示例
json
{
"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",
"data": {
"task_id": "string",
"task_status": "submitted",
"task_info": {
"external_task_id": "string"
},
"created_at": 1722769557708,
"updated_at": 1722769557708
},
"aiping_id": "string"
}查询任务返回（单个/列表元素）
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",
"created_at": 1722769557708,
"updated_at": 1722769557708
},
"aiping_id": "string"
}注意事项
model是兼容字段，建议优先使用model_name。- 多图输入建议直接按
{ "image": "..." }结构传参，最稳定。