Generate Images

POST

/v1/images/generations

OpenAI-compatible image generation endpoint.

Generate images from text prompts using various AI models.
Supports providers like Stability AI (Stable Diffusion), OpenAI (DALL-E), and Google Vertex AI.

Example requests:

DeepInfra:

{
    "prompt": "A serene mountain landscape at sunset",
    "model": "stabilityai/sd3.5",
    "size": "1024x1024",
    "n": 1,
    "provider": "deepinfra"
}

Portkey:

{
    "prompt": "A serene mountain landscape at sunset",
    "model": "stable-diffusion-3.5-large",
    "size": "1024x1024",
    "n": 1,
    "quality": "standard",
    "provider": "portkey",
    "portkey_provider": "stability-ai",
    "portkey_virtual_key": "your-virtual-key-id"
}

Google Vertex AI:

{
    "prompt": "A serene mountain landscape at sunset",
    "model": "stable-diffusion-1.5",
    "size": "512x512",
    "n": 1,
    "provider": "google-vertex",
    "google_project_id": "gatewayz-468519",
    "google_location": "us-central1",
    "google_endpoint_id": "6072619212881264640"
}

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Successful Response

Body

🟠422Unprocessable Entity

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/v1/images/generations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "string",
    "model": "stabilityai/sd3.5",
    "size": "1024x1024",
    "n": 1,
    "quality": "standard",
    "style": "natural",
    "provider": "string",
    "portkey_provider": "string",
    "portkey_virtual_key": "string",
    "google_project_id": "string",
    "google_location": "string",
    "google_endpoint_id": "string"
}'

Response Example

200 - Example 1

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

Modified at 2025-10-27 16:08:25

Check Single Gateway

Log Event