Text-to-image API - Generate images from text descriptions

POST

/v1/images/generations

Generate new images from text descriptions, supporting multiple resolution and aspect ratio configurations.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

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

Body Params application/jsonRequired

Examples

Basic text-to-imageGenerate 4K high-definition imagesGenerate 2K imagesControl generation with sampling parameters

{
"model": "gemini-3.1-flash-image-preview",
"prompt": "A cute orange cat sitting on the windowsill watching the sunset, photographic style, high definition quality"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Basic text-to-imageGenerate 4K high-definition imagesGenerate 2K imagesControl generation with sampling parameters

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

Responses

🟢200

application/json

Request successful

Bodyapplication/json

{
    "created": 1234567890,
    "data": [
        {
            "b64_json": "iVBORw0KGgoAAAANSUhEUgA..."
        }
    ],
    "output_format": "png",
    "usage": {
        "total_tokens": 5234,
        "input_tokens": 234,
        "output_tokens": 5000,
        "input_tokens_details": {
            "text_tokens": 234,
            "image_tokens": 0
        }
    }
}

🟠400

🟠401

🔴500

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

Chat interface - supports text-to-image, image-to-image, and pure conversation

Image-to-image API - Generate new images based on input images