API разработчика модели или единый API: когда лучше напрямую

01Что именно мы сравниваем?

Четыре пункта: цена, ключи, лимиты и оплата. О Rendergrid мы пишем по его документации, о Google и OpenAI — только по официальным ценам за картинку.

• Rendergrid — по своим данным. Цены, ключи, лимиты и оплата описаны так, как их описывает документация Rendergrid.

• Производители — по их ценам. Для Google и OpenAI мы берём официальные цены за картинку; ключи, лимиты и оплату производителей не пересказываем.

• Картинки — только через Rendergrid. Три запроса к Nano Banana 2.1, в 1K и 1:1, по одной попытке. Напрямую к производителю эти промпты не отправлялись.

• Скорость и качество не сравниваем. Трёх картинок для этого мало.

02Сколько стоит картинка?

У Rendergrid цена зависит от модели и разрешения. Nano Banana 2.1 стоит $0,02 в 1K, $0,03 в 2K и $0,04 в 4K; Nano Banana Pro — $0,04, $0,04 и $0,07. Сумма списывается при приёме запроса, а если картинки не получилось, сразу возвращается на баланс: подробнее — в статье о возврате денег за неудачный запрос.

Официальные цены Google за картинку — в таблицах ниже, рядом с ценами Rendergrid. Это стандартный тариф Google, без пакетного режима.

У OpenAI цена картинки зависит от размера и качества, поэтому для каждой модели OpenAI Rendergrid берёт цену квадратной картинки при определённом уровне качества. Какой уровень взят, указано в примечаниях на странице цен; официальные цены OpenAI — по ссылкам в источниках.

Цены по разрешениям — в статьях о Nano Banana 2.1 API и о Nano Banana Pro API.

03Какие ключи и лимиты у Rendergrid?

Ключ API Rendergrid один на все модели аккаунта: префикс rg_live_ и ещё 40 знаков. Полностью его показывают один раз, при создании, а потерянный ключ не восстановить. В аккаунте может быть до 50 ключей, и заменить ключ можно без остановки: создайте новый, проверьте один запрос и только потом отзовите старый.

У ключа нет отдельных прав и своей частоты запросов. Единственное, что для него можно задать, — месячный лимит трат: это жёсткий предел, и когда он исчерпан, запрос получает 402. Такой же лимит можно поставить на весь аккаунт.

Лимиты запросов по умолчанию одинаковы для любого аккаунта и общие для всех его ключей: 120 запросов в минуту и 100 заданий в очереди или в работе. Одно задание можно опрашивать не чаще раза в 5 секунд. При превышении API отвечает 429; если вам не хватает, напишите в поддержку: у аккаунта лимиты могут быть другими. Как не упереться в них, разобрано в статье об ошибке 429.

04Как платить за картинки?

Баланс Rendergrid ведётся в долларах, а пополнить его можно только в USDT: в сети Tron (TRC20), BNB Chain (BEP20) или Solana (SOL). Сумму выбираете вы, и на баланс приходит именно она: комиссию платёжного сервиса платим мы, а плату сети за перевод платит ваш кошелёк. У окна оплаты есть срок, а за крупное пополнение на баланс добавляется бонус; условия — на странице «Пополнение USDT». Подписки нет, деньги уходят только на успешные картинки.

Если вам нужен другой способ оплаты, Rendergrid не подойдёт: другого способа пополнения нет.

05Как выглядят запрос и результат?

Запрос к Rendergrid одинаков для всех моделей: POST /images/generate с полями model, prompt, resolution и aspect_ratio. Чтобы перейти на другую модель, достаточно сменить model, если она поддерживает то же разрешение и тот же формат кадра. Ниже — запрос первой картинки этой статьи.

# Нужны bash, curl и uuidgen. Ключ повтора — один на запрос.
IDEMPOTENCY_KEY="$(uuidgen)" || exit 1
curl --fail-with-body --max-time 30 \
  -X POST https://api.rendergrid.io/api/public/v1/images/generate \
  -H "Authorization: Bearer $RENDERGRID_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
    "model": "nano-banana-2.1",
    "prompt": "Одна зелёная керамическая чашка на бесшовном фоне цвета слоновой кости. Ручка справа, камера на уровне края чашки под небольшим углом. Мягкий свет слева, короткая естественная тень, видны тонкие неровности глазури. Чашка целиком в центре, много свободного пространства. Без надписей, логотипов, людей и водяных знаков.",
    "resolution": "1K",
    "aspect_ratio": "1:1"
  }'

import os
import uuid
import requests

key = os.environ["RENDERGRID_API_KEY"]
payload = {
    "model": "nano-banana-2.1",
    "prompt": "Одна зелёная керамическая чашка на бесшовном фоне цвета слоновой кости. Ручка справа, камера на уровне края чашки под небольшим углом. Мягкий свет слева, короткая естественная тень, видны тонкие неровности глазури. Чашка целиком в центре, много свободного пространства. Без надписей, логотипов, людей и водяных знаков.",
    "resolution": "1K",
    "aspect_ratio": "1:1",
}
response = requests.post(
    "https://api.rendergrid.io/api/public/v1/images/generate",
    headers={
        "Authorization": f"Bearer {key}",
        # новый на каждый запрос; при повторе — тот же
        "X-Idempotency-Key": str(uuid.uuid4()),
    },
    json=payload,
    timeout=(10, 120),
)
response.raise_for_status()
creation = response.json()
print(creation["id"], creation["status"], creation["cost"])

// Node.js 22+, файл .mjs
import { randomUUID } from "node:crypto";

const API = "https://api.rendergrid.io/api/public/v1";
const prompt = "Одна зелёная керамическая чашка на бесшовном фоне цвета слоновой кости. Ручка справа, камера на уровне края чашки под небольшим углом. Мягкий свет слева, короткая естественная тень, видны тонкие неровности глазури. Чашка целиком в центре, много свободного пространства. Без надписей, логотипов, людей и водяных знаков.";

const response = await fetch(`${API}/images/generate`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.RENDERGRID_API_KEY}`,
    "Content-Type": "application/json",
    // новый на каждый запрос; при повторе — тот же
    "X-Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({
    model: "nano-banana-2.1",
    prompt,
    resolution: "1K",
    aspect_ratio: "1:1",
  }),
  signal: AbortSignal.timeout(120_000),
});
if (!response.ok) {
  const body = await response.text();
  throw new Error(`HTTP ${response.status}: ${body}`);
}
const creation = await response.json();
console.log(creation.id, creation.status, creation.cost);

{
  "id": "5b0214ae-9e39-460a-820a-f6ae3e24400b",
  "status": "queued",
  "task_id": "5b0214ae-9e39-460a-820a-f6ae3e24400b",
  "cost": 0.02
}

{
  "id": "5b0214ae-9e39-460a-820a-f6ae3e24400b",
  "status": "completed",
  "result_urls": [
    "https://…"
  ]
}

Ответ 202 значит «принято», а не «готово»; в поле cost стоит сумма в долларах, которую списали за картинку. Готовый результат отдаёт GET /creations/{id} в поле result_urls: файлы хранятся один день, поэтому сохраните картинку у себя. Все шаги — в быстром старте и в статьях про Nano Banana 2.1 API и Nano Banana Pro API.

Три картинки ниже — результаты трёх запросов к Nano Banana 2.1 через Rendergrid: одна чашка, набор посуды и чашка на другом фоне. Запросы шли без референсов, поэтому чашка на каждом кадре своя.

Промпт запроса 1

Одна зелёная керамическая чашка на бесшовном фоне цвета слоновой кости. Ручка справа, камера на уровне края чашки под небольшим углом. Мягкий свет слева, короткая естественная тень, видны тонкие неровности глазури. Чашка целиком в центре, много свободного пространства. Без надписей, логотипов, людей и водяных знаков.

1K · 1:1 · одна попыткаКопировать промпт

Промпт запроса 2

Набор зелёной керамики: чашка, миска и тарелка на бесшовном фоне цвета слоновой кости. Тарелка лежит сзади, миска слева, чашка справа, предметы почти не перекрывают друг друга. Мягкий свет слева, единый оттенок глазури. Покажите весь набор с широкими полями. Без надписей, логотипов, людей и водяных знаков.

1K · 1:1 · одна попыткаКопировать промпт

Промпт запроса 3

Зелёная керамическая чашка с ручкой справа на бледно-терракотовом фоне. Камера около уровня края чашки, мягкий свет слева. Рядом на фоне видна тень одного листа, не пересекающая чашку. Сохраните спокойную предметную композицию: чашка целиком, широкое свободное поле вокруг. Без надписей, логотипов, людей и водяных знаков.

1K · 1:1 · одна попыткаКопировать промпт

06Когда лучше напрямую к производителю?

Единый API — ещё одно звено между вами и производителем, со своими правилами. Он не подойдёт, если вам важно что-то из этого:

• Оплата. Баланс Rendergrid пополняется только в USDT. Если вам нужен другой способ оплаты, проверьте, какие способы есть у производителя.
• Модель или параметр, которых нет в Rendergrid. Через Rendergrid доступны модели из его каталога. В запросе нет маски для правки, а width и height не принимаются: размер задают разрешением и форматом кадра. Если нужно другое, ищите это у производителя.
• Договорные гарантии. Соглашения об уровне сервиса (SLA) у Rendergrid нет. Если оно вам нужно, уточните условия у производителя.
• Лимиты выше стандартных. По умолчанию — 120 запросов в минуту и 100 заданий в работе на аккаунт. Их можно обсудить с поддержкой Rendergrid, а можно сверить с лимитами производителя.
• Меньше посредников. Промпты и образцы проходят через Rendergrid: историю запросов мы храним, пока существует аккаунт, референсы — 48 часов после последней загрузки, готовые файлы — один день. Обучения моделей на данных клиентов нет.

07Когда удобнее единый API?

• Несколько моделей — один доступ. Один ключ API и один баланс на модели Google и OpenAI из каталога, один формат запроса и ответа, а модель выбирается полем model.
• Деньги под контролем. Баланс ведётся в долларах, цену картинки возвращает GET /models, а сумму, списанную за запрос, — поле cost. Месячный лимит трат можно поставить на ключ и на весь аккаунт.
• Неудачный запрос бесплатен. Сумма списывается при приёме запроса и сразу возвращается на баланс, если картинки нет.
• Безопасные повторы и вебхуки. Заголовок X-Idempotency-Key защищает от двойного списания, если запрос придётся повторить, а вместо опроса статуса можно принять вебхук creation.completed или creation.failed с подписью HMAC-SHA256.
• Ключ на каждую интеграцию. До 50 ключей на аккаунт: каждый можно отозвать отдельно, а баланс и лимиты запросов остаются общими.
• Оплата в USDT. Комиссию платёжного сервиса платим мы, а на баланс приходит ровно выбранная сумма.

08Что спросить у производителя?

Условия Google и OpenAI мы не пересказываем. Вот вопросы, ответы на которые стоит найти у производителя:

1. Как выдаётся ключ и можно ли ограничить траты?
2. Какие лимиты у вашего аккаунта и как их поднять?
3. Какие способы и валюты оплаты доступны?
4. Когда списываются деньги и возвращаются ли они, если картинки нет?
5. Как долго хранится готовая картинка и что производитель делает с вашими промптами?
6. Есть ли соглашение об уровне сервиса?

09Где это сравнение не подходит?

• Три картинки — не сравнение моделей. Это три запроса к Nano Banana 2.1 через Rendergrid, по одной попытке: судить по ним о качестве или скорости нельзя.
• Прямого запуска не было. Эти промпты мы не отправляли в API производителя, поэтому не знаем, чем отличался бы результат.
• Условия производителей — не здесь. Ключи, лимиты и оплату Google и OpenAI мы не пересказываем: их надо читать у самих производителей.
• Таблицы цен — только для Nano Banana. Для моделей OpenAI мы даём основание сравнения; цены смотрите на странице цен и у OpenAI.
• Цены — не навсегда. Они указаны на момент проверки: Rendergrid сверяет их с официальными страницами не реже раза в неделю.

10Вопросы и ответы

11Источники

1. Google AI for Developers — цены на APIОфициальные цены Google за картинку: стандартный тариф, без пакетного режима.
2. OpenAI — цены APIОфициальные цены OpenAI.
3. OpenAI — генерация изображений: стоимостьТаблица и калькулятор цены картинки у OpenAI.
4. Цены RendergridЦена за картинку для каждой модели и разрешения.
5. Документация Rendergrid: ключиКлюч API: создание, замена, хранение.
6. Документация Rendergrid: лимитыЧастота запросов и месячные лимиты трат.
7. Документация Rendergrid: пополнение USDTСети, комиссии, окно оплаты.
8. Условия использования RendergridСрок хранения результатов и отсутствие SLA.
9. Политика конфиденциальности RendergridСроки хранения данных и обучение моделей.