Create text-to-image or single image-to-image task

POST

/v1/images/generations

Generate images from text descriptions (text-to-image) or create new images based on a single reference image (single image-to-image) using the Kling V2.1 model. Returns task ID for subsequent queries

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Text-to-imageSingle image-to-imageUsing negative prompt

{
"model": "kling-v2-1",
"prompt": "A cute orange cat sitting on the windowsill watching the sunset, photographic style, high definition quality",
"aspect_ratio": "16:9"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Text-to-imageSingle image-to-imageUsing negative prompt

curl --location 'https://api-xmodel.nexconn.ai/v1/images/generations' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-v2-1",
"prompt": "A cute orange cat sitting on the windowsill watching the sunset, photographic style, high definition quality",
"aspect_ratio": "16:9"
}'

Responses

🟢200Success

application/json

Task created successfully

Bodyapplication/json

Example

{
    "task_id": "image-1762159125266058362-1383010xxx"
}

🟠400Invalid request

🟠401Unauthorized

Modified at 2026-04-24 10:39:56

Query task status

Create multi-image-to-image task