Docs Kling /kling/v1/images/multi-image2image
API reference

Multiple reference pictures

POST/kling/v1/images/multi-image2image

Body Parametersapplication/json

aspect_ratio string

Aspect ratio (W:H) enum: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9

callback_url string

Callback URL invoked on task completion

external_task_id string

Custom external task ID for business-side correlation

model_name* string

Model name enum: kling-v2, kling-v2-1

n* integer

Number of images to generate range: [1,9]

prompt string

Positive text prompt max 2500 characters

scene_image string

Scene reference image accepts image Base64 or a reachable image URL

style_image string

Style reference image accepts image Base64 or a reachable image URL

subject_image_list* array

1–4 images required

items
object object

Responses

200 application/json
response-200 object
400 Bad request or validation failed application/json
response-400 object
properties
error* object
401 Missing or invalid API Key application/json
response-401 object
Request Body Example
1{
2"aspect_ratio": "16:9",
3"callback_url": "",
4"external_task_id": "",
5"model_name": "kling-v2",
6"n": 1,
7"prompt": "根据两张图的特点融合",
8"scene_image": "",
9"style_image": "",
10"subject_image_list": [
11{
12"subject_image": "https://p2-fdl.klingai.com/ksc2/z3PF_5x5kcBzfxZU-uZ66pg5k_lhpifyoCyTFjn_jsKOiBYQGMoR7_kLKO34JyIdJbCSKR3vRneCwiyPHHjTPk01J7Dr65Ovoa7vYQuEh9c4j1_0G03JjIyKUMI58c29jou3zMmAyhzg7p8CrG7esV5agnr2P9XuO5VdTKdr0sUjEDycWEFe07ajsaYFg-wCu7vTJGLD0cr3nvYKnUl-CA.png?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAEeMBuZg7aCbU7N7Rcp5oJ-kfGAN3V073p1GMw7U9oTuISV4gRwnqW7X62AbPhPQVRmzngQDHsFrcGU8kCtzGOJEUWdikBNDmI_JPyD4jpae40CyqnscoIaQhbakFkkDSf515oxxHoFKX2uekXxhaC-Ux41JUupV2RFEPtWRqJtZy4w5ozqI6jbHeVXI7LP_zHpYOGuULmTPK93QFpw13NYPzMPddw3UIRVMrgRQxivnBoS0TR4h_eyjkvDOmDeFijUb3cSIiCmxVk1M5S1rqBZGCnxiZ3evpByg-3YWaVjVOSCzNW4rCgFMAE&x-kcdn-pid=112757&pkey=AAXAHqkraVdXL-kd_qQmLBUx0arOSG4SaHfdeXdQqN5MCBxYZ4QHE_nMRaT_7H8WHOAkbT65kOvXwPx8qkIAOsrbUM980pOy5e_FSqUqJgc_1oYe5msfxxfxRU6wi85LgDw"
13},
14{
15"subject_image": "https://p2-fdl.klingai.com/ksc2/r4gHNdLJu7R_NKFagBrRhUo3pHsXVPKzNvpK03wlneD_9vJUZW305KBZOtLLDMPi3x_S2OA3_kElUJ9OTGiTMJEgl_JquTY_F18h_3T_bUuMAJMwv-Ab4Q0lxaqv5hkTkPf3RiMM-e8L6YDoiu_hqlEWNRoMfcF600L9QjzdeCNWHxt6l1yQHNN-2F1dlnIEEFRCUNtIYl4ld4CTrXU0zQ.png?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAG1PSTwbCq6_SmEkj2U-TQz3h6o_RMO0KUqJXA27NGRFxm-LmGTjaZHzO05ErU-1RdPfZjNK3M0uZQgSW8l2wVcgIou7OGlV4U0SpKzy-YxHgDwmjhlD389wl-rkRst5lcT-7rHQIBfz43n6hQpftalgQdQjzzX9Ba3mYFhNzCtRqeBJDHWZtmqR7Z_VjyVv6JuKd17mIdxVvUnUbrWebqODuRgWdconrxD-f2sXDo2JxoSbgFFnrpiqTZzapT733K7iU3CIiA53wUUSuPo6Nl3x-sMGxPpxWlgCCGZxjsdEzImNu8MQSgFMAE&x-kcdn-pid=112757&pkey=AAVbt25OjExCTX4XvCkIx0TYQ04HQw2NzKf4Lr5yxgJLFDF-iCUXHjGNnRg50Hk2CbkG5E905N4sXT4AkKNgSeYxfSs4YmmPRabsUxE-4lvP915Q3JT0nV1IvaUlXcBPwuY"
16}
17]
18}
Code Sample cURL
1curl -X POST "https://api.digislash.com/kling/v1/images/multi-image2image" \
2-H "Authorization: Bearer <API Key>" \
3-H "Content-Type: application/json" \
4-d '{
5"aspect_ratio": "16:9",
6"callback_url": "",
7"external_task_id": "",
8"model_name": "kling-v2",
9"n": 1,
10"prompt": "根据两张图的特点融合",
11"scene_image": "",
12"style_image": "",
13"subject_image_list": [
14{
15"subject_image": "https://p2-fdl.klingai.com/ksc2/z3PF_5x5kcBzfxZU-uZ66pg5k_lhpifyoCyTFjn_jsKOiBYQGMoR7_kLKO34JyIdJbCSKR3vRneCwiyPHHjTPk01J7Dr65Ovoa7vYQuEh9c4j1_0G03JjIyKUMI58c29jou3zMmAyhzg7p8CrG7esV5agnr2P9XuO5VdTKdr0sUjEDycWEFe07ajsaYFg-wCu7vTJGLD0cr3nvYKnUl-CA.png?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAEeMBuZg7aCbU7N7Rcp5oJ-kfGAN3V073p1GMw7U9oTuISV4gRwnqW7X62AbPhPQVRmzngQDHsFrcGU8kCtzGOJEUWdikBNDmI_JPyD4jpae40CyqnscoIaQhbakFkkDSf515oxxHoFKX2uekXxhaC-Ux41JUupV2RFEPtWRqJtZy4w5ozqI6jbHeVXI7LP_zHpYOGuULmTPK93QFpw13NYPzMPddw3UIRVMrgRQxivnBoS0TR4h_eyjkvDOmDeFijUb3cSIiCmxVk1M5S1rqBZGCnxiZ3evpByg-3YWaVjVOSCzNW4rCgFMAE&x-kcdn-pid=112757&pkey=AAXAHqkraVdXL-kd_qQmLBUx0arOSG4SaHfdeXdQqN5MCBxYZ4QHE_nMRaT_7H8WHOAkbT65kOvXwPx8qkIAOsrbUM980pOy5e_FSqUqJgc_1oYe5msfxxfxRU6wi85LgDw"
16},
17{
18"subject_image": "https://p2-fdl.klingai.com/ksc2/r4gHNdLJu7R_NKFagBrRhUo3pHsXVPKzNvpK03wlneD_9vJUZW305KBZOtLLDMPi3x_S2OA3_kElUJ9OTGiTMJEgl_JquTY_F18h_3T_bUuMAJMwv-Ab4Q0lxaqv5hkTkPf3RiMM-e8L6YDoiu_hqlEWNRoMfcF600L9QjzdeCNWHxt6l1yQHNN-2F1dlnIEEFRCUNtIYl4ld4CTrXU0zQ.png?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAG1PSTwbCq6_SmEkj2U-TQz3h6o_RMO0KUqJXA27NGRFxm-LmGTjaZHzO05ErU-1RdPfZjNK3M0uZQgSW8l2wVcgIou7OGlV4U0SpKzy-YxHgDwmjhlD389wl-rkRst5lcT-7rHQIBfz43n6hQpftalgQdQjzzX9Ba3mYFhNzCtRqeBJDHWZtmqR7Z_VjyVv6JuKd17mIdxVvUnUbrWebqODuRgWdconrxD-f2sXDo2JxoSbgFFnrpiqTZzapT733K7iU3CIiA53wUUSuPo6Nl3x-sMGxPpxWlgCCGZxjsdEzImNu8MQSgFMAE&x-kcdn-pid=112757&pkey=AAVbt25OjExCTX4XvCkIx0TYQ04HQw2NzKf4Lr5yxgJLFDF-iCUXHjGNnRg50Hk2CbkG5E905N4sXT4AkKNgSeYxfSs4YmmPRabsUxE-4lvP915Q3JT0nV1IvaUlXcBPwuY"
19}
20]
21}'
Response
1▼{
2"code": 0,
3▼"data": {
4"task_id": "task_example_001"
5},
6"message": "success"
7}