Skip to main content
POST
Create image
Creates one or more images from a text prompt.

Authorizations

Authorization
string
header
required

Bearer token authentication

Body

application/json
model
string
required
prompt
string
required
models
string[]

Optional ordered fallback models tried after model. model is required and is always the primary model. When an attempt fails with 429, 500, 502, 503, or 504, the next entry is tried; other errors are returned unchanged. Accepts up to 25 model IDs or presets; duplicates and entries equal to model are ignored. Each attempt is validated, logged, and billed as its own request, and the response model field and routing trace show the model that served the request. Streaming requests fall back only before the first byte, and video and music jobs fall back only at submission. Batch, realtime, and council requests reject models. Fallbacks set on a dynamic route take precedence, and phaseo/auto cannot be combined with models.

Required array length: 1 - 25 elements
Minimum string length: 1
Example:
size
string
resolution
string
n
integer
Required range: 1 <= x <= 10
quality
string
stream
boolean
partial_images
integer
Required range: 0 <= x <= 3
output_format
enum<string>
Available options:
png,
jpeg,
webp
output_compression
integer
Required range: 0 <= x <= 100
background
enum<string>
Available options:
transparent,
opaque,
auto
moderation
enum<string>
Available options:
auto,
low
response_format
string
style
string
user
string
provider
object

Provider routing preferences for gateway selection.

Response

Image response

created
integer
data
object[]
Last modified on October 18, 2026