Browse documentation

Generate Images

Generate images through nRouter with one POST to /v1/images/generations, using DALL-E 3 and Imagen 3 through the same key, budgets, and logs as chat.

Generate production images using DALL-E 3 and Imagen 3 through a single POST request to /v1/images/generations under unified API keys, budgets, and audit logs.

Request Syntax & Options

Generate images via /v1/images/generations with your standard key (Quick Start):

curl https://api.nrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $NROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "dall-e-3", "prompt": "A lighthouse at dawn, flat illustration", "response_format": "url"}'
  • Models: dall-e-3, imagen-3, or dall-e-2 from the live catalog.
  • Parameters: size (1024x1024, 1024x1792, 1792x1024), quality (standard/hd), style (vivid/natural), and response_format (url/b64_json). n is fixed to 1 for DALL-E 3; 1–4 for Imagen 3 and DALL-E 2.

Costs settle at list price in request logs via x-nr-request-cost. See Images Generations API, Generate Video, and Errors & Rate Limits.

Frequently asked questions

Can I generate more than one image per call?

n is fixed to 1 for DALL-E 3, and supports 1 to 4 images for Imagen 3 and DALL-E 2.

Do I need a separate key for images?

No; one virtual key and credit balance covers text, vision, audio, and image endpoints.

Which models can I use?

DALL-E 3 and Imagen 3 are available today; verify active models on the live catalog.

Where do I see what an image cost?

Check transaction costs directly in request logs or in the x-nr-request-cost response header.

Was this page helpful?