Omni-Image

POST https://www.kkiai.com/kling/v1/images/omni-image

Request Parameters

Authorization

Add the Authorization parameter to the Header. Its value should be 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-image-o1, kling-v3-omni
prompt	string	Required	Text prompt, can include positive and negative descriptions. Prompts can be templated to meet different image generation needs. Cannot exceed 2500 characters
image_list	array[object]	Optional
└ image	string	Optional
resolution	string	Optional	Clarity of generated images. Enum values: 1k, 2k. 1k: 1K standard definition. 2k: 2K high definition
n	integer	Optional	Number of images to generate. Value range: [1,9]
result_type	string	Optional	Switch for single/series image generation. Enum values: single, series
series_amount	integer	Optional	Number of images in series generation. ● Value range: [2, 9]. This parameter is invalid when result_type is set to single
aspect_ratio	string	Optional	Aspect ratio of generated images (width:height). Enum values: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9, auto. Where: auto generates videos intelligently based on input content. This parameter is invalid when generating new images based on the original image's aspect ratio
watermark_info	object	Optional	Whether to generate results with watermarks. ● Defined through the enabled parameter, carried as key:value pairs, as follows: "watermark_info": { "enabled": boolean // true to generate, false to not generate } ● Custom watermarks are not currently supported
└ enabled	boolean	Required
callback_url	string	Optional
external_task_id	string	Optional

Request Example

{
    "model_name": "kling-image-o1",
    "prompt": "Generate an image of dancing by the seaside.",
    // "image_list": [
    //     {
    //         "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"
    //     }
    // ],
    "element_list": [
        {
            "element_id": 835266081714884677
        }
    ],
    "resolution": "",
    "n": 1,
    "aspect_ratio": "",
    "callback_url": "",
    "external_task_id": ""
}

cURL Example

curl --location --request POST 'https://www.kkiai.com/kling/v1/images/omni-image' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model_name": "kling-image-o1",
    "prompt": "Generate an image of dancing by the seaside.",
    // "image_list": [
    //     {
    //         "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"
    //     }
    // ],
    "element_list": [
        {
            "element_id": 835266081714884677
        }
    ],
    "resolution": "",
    "n": 1,
    "aspect_ratio": "",
    "callback_url": "",
    "external_task_id": ""
}'

Response

🟢 200 Success

Response Example

{}