Last updated: 2026-06-06

GPT Image

gpt-image-2 uses the OpenAI-compatible Images API:

POST /v1/images/generations
POST /v1/images/edits

Use the primary image route https://api.crazyrouter.com/v1 for gpt-image-2. The full generation endpoint is https://api.crazyrouter.com/v1/images/generations. Account login, billing, and the console remain on https://crazyrouter.com.

Generate Image

Request Parameters

Parameter	Type	Required	Description
`model`	string	Yes	Fixed as `gpt-image-2`
`prompt`	string	Yes	Image description prompt
`n`	integer	No	Number of images, default `1`, range `1-10`
`size`	string	No	`auto` or `WxH`. Dimensions must be multiples of 16, each side must be at most 3840, total pixels must be 655360 to 8294400, and the long:short side ratio must not exceed 3:1. Common values: `1024x1024`, `1536x1024`, `1024x1536`
`quality`	string	No	`auto`, `low`, `medium`, `high`. `hd` is accepted for compatibility and normalized to `high`; `standard` is accepted for compatibility and normalized to `auto`
`background`	string	No	`auto` or `opaque`. `transparent` is not supported for `gpt-image-2`
`output_format`	string	No	`png`, `jpeg`, `webp`
`output_compression`	integer	No	`0-100`, only with `output_format=jpeg` or `output_format=webp`
`moderation`	string	No	`auto` or `low`
`stream`	boolean	No	Return an SSE stream
`partial_images`	integer	No	`0-3`, only when `stream=true`
`user`	string	No	End-user identifier

For compatibility with older DALL-E / OpenAI Images clients, gpt-image-2 accepts response_format=url, response_format=b64_json, quality=standard, and style=vivid/natural. response_format and style are not forwarded upstream; quality=standard is normalized to auto.

response_format is only a Crazyrouter compatibility field for legacy clients, not a gpt-image-2 upstream parameter. For new integrations, use output_format="png", "jpeg", or "webp" to choose the image file format, and read data[0].url by default. If a legacy client sends response_format="b64_json", the service tries to preserve base64 response semantics.

These combinations are still rejected: input_fidelity, background=transparent, and output_format=png with output_compression.

Request Examples

curl -X POST https://api.crazyrouter.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A cat wearing a spacesuit walking on the moon with Earth in the background",
    "n": 1,
    "size": "1024x1024",
    "quality": "low",
    "output_format": "png"
  }'

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.crazyrouter.com/v1",
)

response = client.images.generate(
    model="gpt-image-2",
    prompt="A cat wearing a spacesuit walking on the moon with Earth in the background",
    n=1,
    size="1024x1024",
    quality="low",
    output_format="png",
)

print(response.data[0].url)

Streaming

gpt-image-2 supports stream=true. If you send partial_images, you must also set stream=true, and the value must be 0-3.

cURL

curl -N -X POST https://api.crazyrouter.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A simple blue verification icon on a white background",
    "size": "1024x1024",
    "quality": "high",
    "stream": true,
    "partial_images": 2
  }'

Synchronous quality=high requests, including the compatibility value quality=hd, can take a long time. For image workloads, use https://api.crazyrouter.com/v1; for high-quality jobs, prefer stream=true or set your client timeout above 180 seconds.

Response Example

{
  "created": 1778990000,
  "data": [
    {
      "url": "https://media.crazyrouter.com/task-artifacts/2026/05/17/sync-image/request-id-1.png"
    }
  ],
  "output_format": "png",
  "quality": "low",
  "size": "1024x1024"
}

Edit Image

POST /v1/images/edits

Edit an existing image with mask-based region editing support. You can also pass multiple reference images for blending, style transfer, or composition work.

Request Parameters

Parameter	Type	Required	Description
`model`	string	Yes	Fixed as `gpt-image-2`
`image` / `image[]`	file or file[]	Yes	Original image or reference image file(s), sent as multipart; `gpt-image-2` supports up to `16` reference images
`prompt`	string	Yes	Edit description
`mask`	file	No	Mask image; transparent areas indicate regions to edit
`n`	integer	No	Number of images, default `1`, range `1-10`
`size`	string	No	Same rules as generation
`quality`	string	No	`auto`, `low`, `medium`, `high`; `hd` is normalized to `high`
`background`	string	No	`auto` or `opaque`
`output_format`	string	No	`png`, `jpeg`, `webp`
`output_compression`	integer	No	`0-100`, only with `output_format=jpeg` or `output_format=webp`
`stream`	boolean	No	Return an SSE stream
`partial_images`	integer	No	`0-3`, only when `stream=true`

Single-Image Edit Example

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.crazyrouter.com/v1",
)

response = client.images.edit(
    model="gpt-image-2",
    image=open("original.png", "rb"),
    mask=open("mask.png", "rb"),
    prompt="Add a rainbow in the sky",
    n=1,
    size="1024x1024",
    quality="low",
)

print(response.data[0].url)

Multi-Reference Edit Example

Multi-image editing requests must use multipart/form-data. Prefer multiple image[] fields for reference images; repeated image fields are also accepted.

curl -X POST https://api.crazyrouter.com/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gpt-image-2" \
  -F "prompt=Blend the person from the first image with the background from the second image into one natural campaign visual" \
  -F "size=1024x1024" \
  -F "quality=low" \
  -F "n=1" \
  -F "image[]=@person.png" \
  -F "image[]=@background.png"

import requests

response = requests.post(
    "https://api.crazyrouter.com/v1/images/edits",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    data={
        "model": "gpt-image-2",
        "prompt": "Blend the person from the first image with the background from the second image into one natural campaign visual",
        "size": "1024x1024",
        "quality": "low",
        "n": "1",
    },
    files=[
        ("image[]", ("person.png", open("person.png", "rb"), "image/png")),
        ("image[]", ("background.png", open("background.png", "rb"), "image/png")),
    ],
    timeout=240,
)

response.raise_for_status()
print(response.json()["data"][0]["url"])

gpt-image-2 supports up to 16 reference images. Multi-image requests are routed to carriers that support multi-reference image editing.

Chat - OpenAI

Chat - Claude

Chat - Gemini

Chat - Responses API

Image Generation

Video Generation

Audio

Embeddings & Rerank

Other APIs

Reference

GPT Image

GPT Image

Generate Image

Request Parameters

Request Examples

Streaming

Response Example

Edit Image

Request Parameters

Single-Image Edit Example

Multi-Reference Edit Example

​GPT Image

​Generate Image

​Request Parameters

​Request Examples

​Streaming

​Response Example

​Edit Image

​Request Parameters

​Single-Image Edit Example

​Multi-Reference Edit Example

GPT Image

Generate Image

Request Parameters

Request Examples

Streaming

Response Example

Edit Image

Request Parameters

Single-Image Edit Example

Multi-Reference Edit Example