Модели и параметры

01Каталог

Цена указана за одну картинку и зависит от разрешения. Сумма списывается при приёме запроса, а неудачный запрос бесплатен: сумма сразу возвращается на баланс.

Названия моделей — идентификаторы для поля model. Доступные именно вам модели и ваши цены возвращает GET /models: у аккаунта может быть персональная цена или более короткий список.

02Разрешение и формат кадра

• resolution — 1K, 2K или 4K, регистр не важен. Допустимые значения зависят от модели: только 1K у Nano Banana Flash, Nano Banana 2 Lite, GPT Image 2 и GPT Image 2.5.
• Если resolution не указан, картинка рисуется в разрешении по умолчанию: 2K у Nano Banana Pro, 2 и 2.1 и 1K у Flash, 2 Lite и всех моделей GPT Image.
• aspect_ratio — точное значение вида 16:9, без пробелов и перестановки цифр. Набор форматов зависит от модели.
• Если aspect_ratio не указан, будет 1:1. Отсутствие поля не означает auto.
• Разрешение — это уровень размера модели, а не число пикселей. Поля width и height не принимаются; если макету нужен точный размер, проверяйте размеры полученного файла.

Что значит auto

Nano Banana Pro, 2, 2.1 и Flash умеют выбирать формат кадра сами: передайте "aspect_ratio": "auto". С образцами формат, как правило, повторяет первый образец. Без образцов форма кадра не гарантируется: если от неё зависит ваш макет, укажите aspect_ratio явно. У Nano Banana 2 Lite и моделей GPT Image значения auto нет: формат кадра задаёте вы.

Что будет, если выбрать невозможное

Модель, которая не рисует такое разрешение или формат, отвечает 400 до списания. В error.details.supported придёт список допустимых значений, а деньги не тратятся.

HTTP/1.1 400 Bad Request

{
  "error": {
    "code": "ERR_INVALID_REQUEST",
    "message": "Unsupported resolution: 4K. Supported: 1K (case-insensitive) (omit resolution to render 1K).",
    "details": { "resolution": "4K", "supported": ["1K"] }
  }
}

HTTP/1.1 400 Bad Request

{
  "error": {
    "code": "ERR_INVALID_REQUEST",
    "message": "Unsupported aspect_ratio: 5:4. Supported: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 21:9 (omit aspect_ratio to render 1:1).",
    "details": {
      "aspect_ratio": "5:4",
      "supported": [
        "1:1", "16:9", "9:16", "4:3",
        "3:4", "2:3", "3:2", "21:9"
      ]
    }
  }
}

Попробуйте сами: в конструкторе запроса серые варианты показывают такие же отказы.

03Каталог через API

Метод ничего не списывает и не занимает слот генерации. Он входит в общий лимит запросов аккаунта (Лимиты). Параметр category необязателен: для картинок передавайте image.

curl --fail-with-body --max-time 20 \
  "https://api.rendergrid.io/api/public/v1/models?category=image" \
  -H "Authorization: Bearer $RENDERGRID_API_KEY"

import os
from decimal import Decimal
import requests

key = os.environ["RENDERGRID_API_KEY"]
response = requests.get(
    "https://api.rendergrid.io/api/public/v1/models",
    params={"category": "image"},
    headers={"Authorization": f"Bearer {key}"},
    timeout=(5, 20),
)
response.raise_for_status()

for model in response.json()["models"]:
    # цену разрешения берите из variants, а не из корневого price
    prices = {
        v["variant_key"]: Decimal(v["price"])
        for v in model.get("variants", [])
    }
    print(model["id"], prices)

// Node.js 22+, файл .mjs
const base = "https://api.rendergrid.io/api/public/v1";
const url = new URL(`${base}/models`);
url.searchParams.set("category", "image");
const key = process.env.RENDERGRID_API_KEY;
const response = await fetch(url, {
  headers: { Authorization: `Bearer ${key}` },
  signal: AbortSignal.timeout(20_000),
});
if (!response.ok) {
  const body = await response.text();
  throw new Error(`HTTP ${response.status}: ${body}`);
}

for (const model of (await response.json()).models) {
  // цену разрешения берите из variants, а не из корневого price
  const prices = Object.fromEntries(
    (model.variants ?? []).map((v) => [v.variant_key, v.price]),
  );
  console.log(model.id, prices);
}

{
  "currency": "USD",
  "models": [
    {
      "id": "nano-banana-2",
      "category": "image",
      "display_name": "Nano Banana 2",
      "price": "0.0250",
      "unit": "per_image",
      "variants": [
        { "variant_key": "1k", "price": "0.0250" },
        { "variant_key": "2k", "price": "0.0400" },
        { "variant_key": "4k", "price": "0.0600" }
      ]
    },
    {
      "id": "gpt-image-2.5",
      "category": "image",
      "display_name": "GPT Image 2.5",
      "price": "0.0250",
      "unit": "per_image",
      "variants": [
        { "variant_key": "1k", "price": "0.0250" }
      ]
    }
  ]
}

currency

Валюта всех сумм в ответе: USD.

id

Идентификатор модели для поля model в запросе генерации.

price

Цена самого дешёвого разрешения модели, строкой в долларах. Это не цена вашей картинки: она зависит от resolution.

unit

Единица цены: per_image — за одну картинку.

variants

Цены по разрешениям: variant_key (1k, 2k, 4k) и price; в полном ответе у варианта есть ещё display_name и unit. Берите цену выбранного разрешения здесь.

04Цена и списание

Цена картинки зависит от модели и разрешения. Например, Nano Banana 2.1 стоит $0,02 в 1K, $0,03 в 2K и $0,04 в 4K, а GPT Image 2 — $0,02 в 1K. Самая низкая цена — $0,015 за картинку в 1K у Nano Banana Flash и Nano Banana 2 Lite.

Если resolution не указан, картинка рисуется и оплачивается в разрешении по умолчанию — для Nano Banana Pro, 2 и 2.1 это 2K, хотя корневое price в каталоге показывает 1K. Сумма попадает в поле cost ответа 202.

FAQЧастые вопросы