v1

latestOpenAPI 3.1.0Commercial2026-07-26232551.7 KB

Images

Create an image

Supported across providers: OpenAI (gpt-image-1, gpt-image-1-mini, gpt-image-1.5), Google Imagen (imagen-4.0-{fast,standard,ultra}-generate-001), and xAI Grok (grok-imagine-image, grok-imagine-image-pro).

post/images/generations

Request body

modelstring required

Image-generation model. OpenAI / Google Imagen / xAI Grok families are all served on this endpoint.

promptstring required

ninteger

sizestring

OpenAI-style size like 1024x1024. For models that use aspect-ratio instead (Gemini Imagen), OrcaRouter maps 1024x1024 → 1:1, 1792x1024 → 16:9, etc.

style'vivid' | 'natural'

response_format'url' | 'b64_json'

userstring

Example request

{
  "model": "openai/gpt-image-1",
  "size": "1024x1024"
}

Response

createdinteger