Multi-Image Reference Image Generation

POST https://www.kkiai.com/kling/v1/images/multi-image2image

Request Parameters

Authorization

Add the Authorization parameter to the Header. Its value is the Token concatenated after Bearer.

Example: Authorization: Bearer ********************

Header Parameters

Parameter Name	Type	Required	Description	Example
Content-Type	string	Optional		application/json
Authorization	string	Optional		Bearer {{YOUR_API_KEY}}

Body Parameters (application/json)

Parameter Name	Type	Required	Description
model_name	string	Required	Model name. Enum values: kling-v2, kling-v2-1
prompt	string	Optional	Positive text prompt. Cannot exceed 2500 characters
subject_image_list	array[object]	Required	Supports up to 4 images, minimum 1 image
└ subject_image	string	Required
scene_image	string	Optional	Scene reference image. Supports Base64 encoded image or image URL (must be accessible)
style_image	string	Optional	Style reference image. Supports Base64 encoded image or image URL (must be accessible)
n	integer	Required	Number of images to generate. Value range: [1,9]
aspect_ratio	string	Optional	Aspect ratio of generated image (width:height). Enum values: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9
callback_url	string	Optional
external_task_id	string	Optional

Request Example

{
    "model_name": "kling-v2",
    "prompt": "Blend the characteristics of the two images.",
    "subject_image_list": [
        {
            "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"
        },
        {
            "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"
        }
    ],
    "scene_image": "",
    "style_image": "",
    "n": 1,
    "aspect_ratio": "16:9",
    "callback_url": "",
    "external_task_id": ""
}

cURL Example

curl --location --request POST 'https://www.kkiai.com/kling/v1/images/multi-image2image' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model_name": "kling-v2",
    "prompt": "Blend the characteristics of the two images.",
    "subject_image_list": [
        {
            "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"
        },
        {
            "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"
        }
    ],
    "scene_image": "",
    "style_image": "",
    "n": 1,
    "aspect_ratio": "16:9",
    "callback_url": "",
    "external_task_id": ""
}'

Response

🟢 200 Success

Response Example

{}