Skip to main content
  • 路径 POST /kling/v1/images/multi-image2image
  • 与官网一致：本页所有请求体、字段命名与返回结构与可灵官网保持一致
  • 字段详解：请参考官网权威文档
请求参数
参数类型必填说明
model_namestring否模型名称，仅支持 kling-v2
promptstring否正向文本提示词
subject_image_listarray是主体图片列表，1-4张
scene_imagestring否场景参考图 URL 或 Base64
style_imagestring否风格参考图 URL 或 Base64
nint否生成图片数量 [1, 9]，默认 1
aspect_ratiostring否纵横比：16:9、9:16、1:1、4:3、3:4、3:2、2:3、21:9
callback_urlstring否回调通知地址
external_task_idstring否自定义任务ID
subject_image_list 格式 
{
  "subject_image_list": [
    {"subject_image": "https://example.com/subject1.jpg"},
    {"subject_image": "https://example.com/subject2.jpg"}
  ]
}

​
场景一：单主体图生成

curl --request POST \
  --url https://models.kapon.cloud/kling/v1/images/multi-image2image \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model_name": "kling-v2",
    "prompt": "The subject wearing a red dress in a garden",
    "subject_image_list": [
      {"subject_image": "https://example.com/person.jpg"}
    ],
    "n": 2,
    "aspect_ratio": "3:4"
  }'

​
场景二：多主体 + 场景参考

curl --request POST \
  --url https://models.kapon.cloud/kling/v1/images/multi-image2image \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model_name": "kling-v2",
    "prompt": "Two friends having a picnic together",
    "subject_image_list": [
      {"subject_image": "https://example.com/person1.jpg"},
      {"subject_image": "https://example.com/person2.jpg"}
    ],
    "scene_image": "https://example.com/park-scene.jpg",
    "n": 1,
    "aspect_ratio": "16:9"
  }'

​
场景三：主体 + 风格迁移

curl --request POST \
  --url https://models.kapon.cloud/kling/v1/images/multi-image2image \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model_name": "kling-v2",
    "prompt": "Portrait in oil painting style",
    "subject_image_list": [
      {"subject_image": "https://example.com/portrait.jpg"}
    ],
    "style_image": "https://example.com/oil-painting-style.jpg",
    "n": 1,
    "aspect_ratio": "1:1"
  }'
示例响应 
{
  "code": 0,
  "message": "success",
  "request_id": "req_1735558800_multi456",
  "data": {
    "task_id": "task_01JGHQ...",
    "task_status": "submitted",
    "created_at": 1735558800000,
    "updated_at": 1735558800000
  }
}
任务查询 
# 查询单个任务
curl "https://models.kapon.cloud/kling/v1/images/multi-image2image/$TASK_ID" \
  -H "Authorization: Bearer $TOKEN"

# 查询任务列表
curl "https://models.kapon.cloud/kling/v1/images/multi-image2image?pageNum=1&pageSize=30" \
  -H "Authorization: Bearer $TOKEN"