Docs

Images

Image generation — billed per image, capped at 10 per request.

curl https://iranrouter.com/v1/images/generations \
  -H "Authorization: Bearer ir-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-1",
    "prompt": "یک گربه روی پشت‌بام تهران، نقاشی آبرنگ",
    "n": 1,
    "size": "1024x1024"
  }'

How it is billed

• The price is per image, so n is a direct cost multiplier. Newer models bill tokens as well; whichever the model quotes is what applies.
• A hard ceiling of n = 10 per request — a larger value is clamped to 10 rather than rejected, and that same count is reserved from your wallet before the request goes out.
• The image count on the usage row is the length of data in the response — what was actually produced.

For the cost breakdown, see billing.