Image generation models

Openference exposes image models on POST /v1/images/generations. Stable Diffusion models (Cloudflare) use pixel size and optional diffusion controls. Each successful image consumes plan requests at the model’s ratio (see Model Request Ratios). Use the model ids below in your request body. Aliases are also accepted (e.g. sdxl-lightning → SDXL Lightning).

SDXL Lightning (`sdxl-lightning`)

Task: text-to-image
Best for: fast previews and drafts (few diffusion steps)

Parameter	Default	Range / notes
`prompt`	—	Required
`size`	`1024x1024`	256–2048 px, multiples of 8
`num_steps`	4	1–20
`guidance`	7.5	Positive number
`negative_prompt`	—	Optional
`seed`	—	Optional integer

curl https://api.openference.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sdxl-lightning",
    "prompt": "A red cube on a white background, product photo",
    "size": "1024x1024",
    "num_steps": 4
  }'

SDXL Base 1.0 (`sdxl-base`)

Task: text-to-image
Best for: higher-quality still images (more steps than Lightning)

Parameter	Default	Range / notes
`prompt`	—	Required
`size`	`1024x1024`	256–2048 px, multiples of 8
`num_steps`	20	1–20
`guidance`	7.5	Positive number
`negative_prompt`	—	Optional
`seed`	—	Optional integer

curl https://api.openference.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sdxl-base",
    "prompt": "Oil painting of a mountain lake at sunset",
    "size": "1024x1024",
    "num_steps": 20,
    "guidance": 7.5
  }'

Errors

HTTP	Code	Meaning
400	`invalid_num_steps`	`num_steps` out of range for the model

See POST /v1/images/generations and Common errors for the full list.

Getting Started

API Reference

Client Integrations

Models

Billing, Quotas & Usage

API Keys & Security

Reliability & Architecture

Troubleshooting

Reference

FAQ

Image generation models

Image generation models

SDXL Lightning (`sdxl-lightning`)

SDXL Base 1.0 (`sdxl-base`)

Errors

​Image generation models

​SDXL Lightning (sdxl-lightning)

​SDXL Base 1.0 (sdxl-base)

​Errors

Image generation models

SDXL Lightning (`sdxl-lightning`)

SDXL Base 1.0 (`sdxl-base`)

Errors