Неудачный запрос бесплатен: как устроена оплата за картинку

01Когда деньги списываются и когда возвращаются?

Сумма списывается при приёме запроса, до начала работы, и приходит в поле cost ответа 202. Для Nano Banana 2.1 в 2K это $0,03. Цены проверены 26 октября 2026. Ответ 202 значит «запрос принят», а не «картинка готова».

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

Все три картинки в статье — обычные успешные результаты: у неудачного запроса картинки нет, показывать нечего.

Промпт этой картинки

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

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

02Какие запросы ничего не списывают?

Возврат нужен только там, где деньги уже взяты.

• Запрос не принят. Ответ приходит до списания, баланс не меняется: 400 ERR_INVALID_REQUEST (например, пустой промпт или разрешение, которого нет у модели), 422 ERR_INPUT_FETCH_FAILED, когда образец не удалось скачать, и 503 с overloaded в details.reason.
• Запрос принят, картинки нет. Списание уже прошло, задание получает статус failed, сумма возвращается сама.
• Сбой сервиса. При 500 ERR_GENERATION_FAILED списанная сумма возвращается сама. То же сказано про ERR_INTERNAL, если запрос ничего не создал, и про 503 с provider_unavailable, если деньги списывали.

Новая попытка после failed — отдельный запрос с новым ключом повтора: прежний ключ задание не перезапустит. Она оплачивается как обычно и возвращается, если и она не удалась. Ключ повтора описан в документации: повтор без двойного списания.

03Как это видно в ответе API?

Принятый запрос и итог задания — два разных ответа. Сначала приходит 202 с полями id, status, task_id и cost; результат вы забираете запросом GET /creations/{id} или вебхуком.

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

{
  "id": "5b0214ae-9e39-460a-820a-f6ae3e24400b",
  "status": "failed",
  "error": "The image or prompt was rejected by the safety filter. Try a different image or rephrase the prompt.",
  "failure": {
    "type": "declined",
    "code": "content_policy",
    "retryable": false
  }
}

Если картинки нет, GET /creations/{id} отвечает 200 со статусом failed: это итог задания, а не ошибка запроса статуса. Текст error — для показа, на английском. Логику стройте по объекту failure: тип declined значит, что причина в самом запросе и тот же запрос даст тот же результат, а тип error — что причина на стороне сервиса и запрос можно отправить снова, если retryable не равен false. Деньги возвращаются при обоих типах. Тот же объект failure приходит в вебхуке creation.failed.

В коде это выглядит так:

CREATION_ID="5b0214ae-9e39-460a-820a-f6ae3e24400b"
curl --fail-with-body --max-time 20 \
  "https://api.rendergrid.io/api/public/v1/creations/$CREATION_ID" \
  -H "Authorization: Bearer $RENDERGRID_API_KEY"

import os
import requests

API = "https://api.rendergrid.io/api/public/v1"
KEY = os.environ["RENDERGRID_API_KEY"]
creation_id = "5b0214ae-9e39-460a-820a-f6ae3e24400b"

response = requests.get(
    f"{API}/creations/{creation_id}",
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=(5, 20),
)
response.raise_for_status()
creation = response.json()

if creation["status"] == "failed":
    # failure может отсутствовать, поэтому читаем его осторожно
    failure = creation.get("failure") or {}
    print(failure.get("type"), failure.get("code"), failure.get("retryable"))

// Node.js 22+, файл .mjs
const API = "https://api.rendergrid.io/api/public/v1";
const id = "5b0214ae-9e39-460a-820a-f6ae3e24400b";
const key = process.env.RENDERGRID_API_KEY;
const response = await fetch(`${API}/creations/${id}`, {
  headers: { Authorization: `Bearer ${key}` },
  signal: AbortSignal.timeout(20_000),
});
if (!response.ok) {
  const body = await response.text();
  throw new Error(`HTTP ${response.status}: ${body}`);
}
const creation = await response.json();
if (creation.status === "failed") {
  const { type, code, retryable } = creation.failure ?? {};
  console.log(type, code, retryable);
}

Промпт этой картинки

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

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

04Как это видно в личном кабинете?

В кабинете возврат виден в двух местах. В разделе «Баланс и пополнение» журнал операций показывает списание с типом «Списание» и описанием «Генерация»; у успешной генерации его статус «Завершена». Если запрос не удался, у списания статус «Возвращена», а отдельная строка с типом «Возврат» и описанием «Возврат за неудачный запрос» показывает вернувшуюся сумму.

В разделе «Аналитика» под ошибками по типам указано, сколько вернулось на баланс за выбранный период.

Промпт этой картинки

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

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

05Где автоматический возврат не помогает?

• Ответ с ошибкой не подтверждает возврат. Сумму видно на балансе и в журнале операций кабинета: сверяйтесь с ними.
• Ответ 500 не говорит, принят ли запрос. Не создавайте новое задание: повторите тот же запрос с тем же ключом повтора, чтобы не заплатить дважды.
• Новая попытка — новая оплата. Она оплачивается как обычный запрос и возвращается, только если и она не удалась.

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

07Источники

1. Документация Rendergrid: создание картинкиЦена и списание, поле cost.
2. Документация Rendergrid: задачи и статусыСтатус failed и ответ на него.
3. Документация Rendergrid: балансКогда деньги списываются и возвращаются.
4. Документация Rendergrid: коды ошибокЧто списывается при каждой ошибке, объект failure.
5. Кабинет RendergridЖурнал операций в разделе «Баланс и пополнение», итог возвратов в «Аналитике».