Models

The catalog returns models available to your account and your per-image prices. Use it as the source of current pricing.

Available models

Models are grouped into GPT Image and Nano Banana. Capabilities are listed per model below; GET /models returns your account’s availability and effective prices.

All listed models support asynchronous generation and references through image_file_ids or image_urls — up to 14 per request. Retrieve results by polling or webhook. Unsupported parameters are rejected before charging.

GPT Image

gpt-image-2

• Aspect ratios: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 5:4, 4:5, 21:9.
• Resolutions: 1K, 2K, 4K.
• Defaults: aspect_ratio=1:1, resolution=2K.

gpt-image-2.5-sunburst

• Aspect ratios: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 5:4, 4:5, 21:9, 9:21, 7:5, 5:7.
• Resolutions: 1K.
• Defaults: aspect_ratio=1:1, resolution=1K.

1K: approximately 1.57 MP, with a measured square output of 1254×1254.

gpt-image-2.5-flare

• Aspect ratios: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 5:4, 4:5, 21:9, 9:21, 7:5, 5:7.
• Resolutions: 1K.
• Defaults: aspect_ratio=1:1, resolution=1K.

1K: approximately 1.57 MP, with a measured square output of 1254×1254.

Nano Banana

auto lets the model choose the aspect ratio from your request.

nano-banana-2

• Aspect ratios: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 5:4, 4:5, 21:9, 1:4, 1:8, 4:1, 8:1, auto.
• Resolutions: 1K, 2K, 4K.
• Defaults: aspect_ratio=1:1, resolution=2K.

Also supports google_search.

nano-banana-pro

• Aspect ratios: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 5:4, 4:5, 21:9, auto.
• Resolutions: 1K, 2K, 4K.
• Defaults: aspect_ratio=1:1, resolution=2K.

Also supports output_format: png or jpg.

nano-banana-flash

• Aspect ratios: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 5:4, 4:5, 21:9, auto.
• Resolutions: 1K.
• Defaults: aspect_ratio=1:1, resolution=1K.

Request parameters and examples.

Pricing

All prices are per image in USD. resolution selects the price variant. gpt-image-2.5-sunburst, gpt-image-2.5-flare and nano-banana-flash support only 1K; omitting the parameter also renders and bills 1k; gpt-image-2 currently renders 1K only as well. nano-banana-2 and nano-banana-pro default to 2K and the 2k variant. A resolution unsupported by the selected model is rejected before charging.

Your contract may carry per-model or per-variant overrides, so treat GET /models as the source of truth for prices: each entry's variants[] ladder carries your exact per-resolution prices. Each request generates exactly one image at its variant's price. See Generate image for the parameters that select a variant.

List models

Requires authentication. Supports an optional ?category= filter (e.g. ?category=image); an unknown category returns 400 ERR_INVALID_REQUEST with the allowed values in details.allowed.

The response carries a top-level currency — the ISO-4217 code every money amount in the response is denominated in ("USD" on Rendergrid) — and a models array. Each entry carries id, category, display_name, price (a decimal string — your account's price for the headline variant), unit, and a variants price ladder with one priced tier per resolution. The prices below are example values — your response carries your account's effective prices:

{
  "currency": "USD",
  "models": [
    {
      "id": "nano-banana-2",
      "category": "image",
      "display_name": "Nano Banana 2",
      "price": "0.1000",
      "unit": "per_image",
      "variants": [
        { "variant_key": "1k", "display_name": "1K", "price": "0.1000", "unit": "per_image" },
        { "variant_key": "2k", "display_name": "2K", "price": "0.1000", "unit": "per_image" },
        { "variant_key": "4k", "display_name": "4K", "price": "0.1000", "unit": "per_image" }
      ]
    }
  ]
}