Skip to main content
POST
Generate images (OpenAI-compatible)

Authorizations

Authorization
string
header
required

Gateway API key (imp-rt-...) from POST /v1/accounts or /v1/keys.

Body

application/json
model
string
required

Canonical image model ID from GET /v1/models.

Example:

"google/gemini-3.1-flash-image"

prompt
string
required
n
integer
default:1

Number of images to generate. Gemini supports only 1.

size
string

{width}x{height} or auto. Gemini supports square 1024, 2048, or 4096 dimensions; Flash Lite Image only 1024.

quality
enum<string>

Gemini supports auto only.

Available options:
auto,
low,
medium,
high,
standard,
hd
background
enum<string>

Gemini supports auto only.

Available options:
auto,
transparent,
opaque
output_format
enum<string>

OpenAI only. Omit for Gemini and read data[].mime_type.

Available options:
png,
jpeg,
webp
output_compression
integer

OpenAI JPEG/WebP only; unsupported for Gemini.

Required range: 0 <= x <= 100
user
string

Stable per-user id forwarded to OpenAI for abuse monitoring; unsupported for Gemini.

Response

Generated images with token usage.

created
integer
data
object[]
usage
object