Generate images with Gemini

POST

/v1/images/generations

Generate one Gemini image (n=1). Returns base64 PNG; response_format=url returns a data URL. Size selects an aspect ratio.

Request

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Generated image(s)

Headers

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🔴502ProviderError

🔴503Unavailable

Request Example

Shell

JavaScript

Java

Swift

cURL

1024x1024 photoBase64 response

curl --location '/v1/images/generations' \
--header 'Content-Type: application/json' \
--data '{
    "prompt": "A photorealistic lighthouse at dusk, golden hour lighting.",
    "model": "gemini-2.5-flash-image",
    "size": "1024x1024",
    "quality": "hd",
    "provider": "gemini"
}'

Response Example

200 - Example 1

{
    "created": 0,
    "data": [
        {
            "url": "string",
            "b64_json": "string",
            "revised_prompt": "string"
        }
    ]
}

Modified at 2026-10-20 19:28:20

Text-to-speech

List available models