Models

Rendergrid currently serves two image models: nano-banana-2 and nano-banana-pro. The catalog endpoint returns the models available to your account together with your per-image prices — use it as the source of truth for pricing rather than hardcoding values.

Available models

nano-banana-2

Fast, low-cost general-purpose image generation — built for high-volume catalog, thumbnail, and content workloads.

• Pricing: per image, per resolution variant — your effective prices come from GET /models.
• Aspect ratios: via aspect_ratio — one of 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 5:4, 4:5, 21:9. Matched exactly; any other value is rejected with 400 ERR_INVALID_REQUEST before anything is charged. Defaults to 1:1 when omitted — see POST /images/generate.
• Resolution tiers: 1K / 2K / 4K via resolution (case-insensitive; defaults to 2K when omitted). Any other value is rejected with 400 ERR_INVALID_REQUEST before anything is charged. Each resolution bills its own variant (1k / 2k / 4k).
• Image-to-image: yes — up to 14 reference images via image_file_ids.
• Extras: Google Search grounding via google_search (this model only).

nano-banana-pro

Higher-fidelity output for hero images and marketing assets, with stronger detail and prompt adherence.

• Pricing: per image, per resolution variant — your effective prices come from GET /models.
• Aspect ratios: via aspect_ratio — one of 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 5:4, 4:5, 21:9. Matched exactly; any other value is rejected with 400 ERR_INVALID_REQUEST before anything is charged. Defaults to 1:1 when omitted — see POST /images/generate.
• Resolution tiers: 1K / 2K / 4K via resolution (case-insensitive; defaults to 2K when omitted). Any other value is rejected with 400 ERR_INVALID_REQUEST before anything is charged. Each resolution bills its own variant (1k / 2k / 4k).
• Image-to-image: yes — up to 14 reference images via image_file_ids.
• Extras: output_format choice of png or jpg.

Pricing

All prices are per image, in USD. Every model is priced per resolution — the resolution parameter selects the variant that is billed (1k / 2k / 4k). A request that omits resolution generates at 2K and bills the 2k variant.

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" }
      ]
    }
  ]
}