Skip to content

GPT Image 2 Image Generation ​

OmniRouters OpenAI image protocol reference for the gpt-image-2 model.

Endpoint ​

POST /v1/images/generations

Minimal request ​

bash
curl https://omnirouters.com/v1/images/generations \
  -H "Authorization: Bearer $OMNIROUTERS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{\n  "model": "gpt-image-2",\n  "prompt": "A cinematic flower in a glasshouse",\n  "size": "1024x1024",\n  "quality": "high",\n  "n": 1\n}'

This operation creates a new image from a text prompt.

Request body ​

FieldTypeRequiredDescription
modelstring必填固定使用 gpt-image-2。
promptstring必填Image prompt.
sizestring否输出尺寸,例如 1024x1024。
qualitystring否图片质量:low、medium 或 high。
ninteger否生成数量。

The response may return Base64 data in data[].b64_json or a hosted URL in data[].url, depending on the model.

Response body ​

json
{
  "created": 1782875947,
  "data": [
    { "b64_json": "{image_base64_string}" }
  ]
}

Notes ​

Model-specific validation and output availability depend on the selected model and current OmniRouters routing configuration. For shared routing guidance, see Omni-Image API.