Картинка не пришла: отказ по содержанию и что с ним делать

01Почему вместо картинки приходит отказ?

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

API называет оба случая отказом (declined): причина в самом запросе, а не в сервисе. В статистике личного кабинета отказы считаются отдельно от ошибок и подписаны причиной, например «Отказ по правилам содержания» или «Модель ответила без картинки».

02Как отказ выглядит в ответе API?

Сначала запрос принимается: POST /images/generate отвечает 202, а сумма списывается сразу и приходит в поле cost. Отказ приходит позже: GET /creations/{id} отвечает 200, но со статусом failed. Это итог задания, а не ошибка запроса статуса.

{
  "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": "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
  }
}

Объект failure есть только у failed, поэтому при разборе считайте его необязательным. Строка error — текст для людей на английском, и формулировка может меняться: логику стройте по failure.type и failure.code.

Список кодов пока закрыт, но новые могут появиться: незнакомый код обрабатывайте по его failure.type.

Тип declined — причина в самом запросе, повтор без изменений не поможет:

• content_policy — правила содержания отклонили промпт или образец: измените промпт или возьмите другую картинку.
• no_image_output — модель ответила текстом вместо картинки: опишите нужную картинку или приложите фото, на которое ссылается промпт.
• source_image_rejected — исходная картинка отклонена: возьмите другое фото.
• reference_unavailable и invalid_request — образец недоступен или запрос нельзя выполнить в таком виде: загрузите файл заново или исправьте запрос.

Тип error — сбой на стороне сервиса (timeout, unavailable, reference_fetch_failed, internal): такой запрос можно отправить снова, если retryable не равен false. Полный список — в документации.

Так разобрать ответ в коде:

curl https://api.rendergrid.io/api/public/v1/creations/5b0214ae-9e39-460a-820a-f6ae3e24400b \
  -H "Authorization: Bearer $RENDERGRID_API_KEY"

import os

import requests

API = "https://api.rendergrid.io/api/public/v1"
creation_id = "5b0214ae-9e39-460a-820a-f6ae3e24400b"

response = requests.get(
    f"{API}/creations/{creation_id}",
    headers={"Authorization": f"Bearer {os.environ['RENDERGRID_API_KEY']}"},
    timeout=(5, 20),
)
response.raise_for_status()
creation = response.json()

if creation["status"] == "failed":
    # объект failure считайте необязательным
    failure = creation.get("failure") or {}
    if failure.get("type") == "declined":
        # причина в запросе: меняйте промпт или исходную картинку
        print("declined:", failure.get("code"))
    elif failure.get("retryable") is not False:
        # сбой сервиса: отправьте новый запрос с новым ключом повтора
        print("error:", failure.get("code"))

// Node.js 22+, файл .mjs
const API = "https://api.rendergrid.io/api/public/v1";
const id = "5b0214ae-9e39-460a-820a-f6ae3e24400b";

const response = await fetch(`${API}/creations/${id}`, {
  headers: { Authorization: `Bearer ${process.env.RENDERGRID_API_KEY}` },
  signal: AbortSignal.timeout(20_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const creation = await response.json();

if (creation.status === "failed") {
  // объект failure считайте необязательным
  const failure = creation.failure ?? {};
  if (failure.type === "declined") {
    // причина в запросе: меняйте промпт или исходную картинку
    console.log("declined:", failure.code);
  } else if (failure.retryable !== false) {
    // сбой сервиса: отправьте новый запрос с новым ключом повтора
    console.log("error:", failure.code);
  }
}

03Вернутся ли деньги за отказ?

Да. Сумма списывается при приёме запроса, а если картинки нет, сразу возвращается на баланс: так и при отказе, и при сбое сервиса. Ответ об ошибке возврат не подтверждает, поэтому проверьте баланс и журнал операций в кабинете. Отказы в долю успешных запросов не входят и показаны в статистике отдельно. Подробнее — в статье «Неудачный запрос бесплатен: как устроена оплата за картинку».

04Как переписать промпт, который поняли не так?

Если вы уверены, что запрос безобидный, меняйте его текст: тот же запрос даст тот же результат. Новая попытка — это новый запрос с новым X-Idempotency-Key: прежний ключ задание не перезапустит. Она оплачивается как обычно и возвращается, если не удалась.

1. Опишите сам кадр. Назовите предмет, его число, фон, свет и положение в кадре вместо отсылок вроде «как на прошлой картинке»: промпт, который ссылается на не приложенную картинку, может закончиться ответом без картинки (no_image_output).
2. Приложите то, на что ссылаетесь. Если правите фото, передайте его образцом и всё равно опишите правку в промпте: промпт нужен всегда.

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

Промпт к картинке

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

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

Промпт к картинке

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

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

Промпт к картинке

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

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

05Когда переписывание не поможет?

• Это не обход правил. Если запрос им не соответствует, мы не обещаем, что следующая попытка пройдёт, и не объясняем, как правила обойти.
• Три картинки — не проверка. По одной попытке на промпт: это форма промпта, а не доля принятых запросов.
• Причина не в тексте. source_image_rejected и reference_unavailable решаются заменой или повторной загрузкой файла, а не переписыванием промпта.
• Сбой сервиса — не отказ. Тип error не требует менять промпт: отправьте запрос снова, если retryable не равен false.

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

07Источники

1. Документация Rendergrid: коды ошибокТипы declined и error, коды причин и возврат суммы.
2. Документация Rendergrid: задачи и статусыСтатус failed и как читать ответ о задании.
3. Документация Rendergrid: создание картинкиСписание суммы при приёме запроса и поле cost.
4. Неудачный запрос бесплатен: как устроена оплата за картинкуВозврат суммы за запрос без картинки.
5. Три картинки статьиNano Banana 2.1, 1K, формат 1:1, одна попытка на каждую; промпт стоит у картинки.