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

POST

/v1/images/edits

Generate new images based on input images and text descriptions, supporting image editing, style transfer, and content modification. Output resolution is 1K.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

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

Body Params application/jsonRequired

Examples

Basic image-to-imageUsing multiple input imagesStyle transferUsing Base64 input images

{
"model": "gemini-2.5-flash-image",
"image": "https://aitoken-public.qnaigc.com/example/generate-video/running-man.jpg",
"prompt": "Add a sunset effect to this scene to make the overall tone warmer"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Basic image-to-imageUsing multiple input imagesStyle transferUsing Base64 input images

curl --location 'https://api-xmodel.nexconn.ai/v1/images/edits' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-2.5-flash-image",
"image": "https://aitoken-public.qnaigc.com/example/generate-video/running-man.jpg",
"prompt": "Add a sunset effect to this scene to make the overall tone warmer"
}'

Responses

🟢200Success

application/json

Request successful

Bodyapplication/json

Example

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

🟠400Invalid request

🟠401Unauthorized

🔴500Internal server error

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

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

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