Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://docs.runblob.io/llms.txt

Use this file to discover all available pages before exploring further.

Формат ответа при ошибке

Когда генерация падает, поле message содержит код ошибки:
{
  "task_uuid": "ffd473d5-5bef-4e14-bf22-8d559be3c19f",
  "status": "failed",
  "prompt": "...",
  "result_image_url": null,
  "message": "MODERATION_FAILED"
}

Коды ошибок

КодОписаниеРешение
INSUFFICIENT_CREDITSНедостаточно балансаПополните аккаунт
MODERATION_FAILEDКонтент заблокирован фильтрамиИзмените промпт
API_ERRORОшибка внешнего APIПовторите запрос
TASK_FAILEDВнутренняя ошибка генерацииПовторите запрос
TIMEOUTГенерация заняла слишком много времениПовторите с упрощённым промптом
INVALID_IMAGEНевалидное входное изображениеПроверьте формат и кодировку
IMAGE_TOO_LARGEИзображение больше 20MBСожмите изображение
UNSUPPORTED_IMAGE_FORMATНеверный формат изображенияИспользуйте JPEG, PNG или WEBP

HTTP-статусы

СтатусОписание
201Генерация создана успешно
400Невалидные параметры запроса
401Невалидный или отсутствующий ключ
402Недостаточно кредитов
404Генерация не найдена
500Ошибка сервера

Ошибки валидации

Неверная комбинация Model/Quality

{
  "detail": "Quality 2k/4k is only available for Pro and V2 models"
}
Решение: используйте параметр quality только с model: "pro" или model: "v2"

Неверная длина промпта

{
  "detail": [
    {
      "loc": ["body", "prompt"],
      "msg": "String should have at least 1 character",
      "type": "string_too_short"
    }
  ]
}
Решение: передавайте промпт длиной 1–4000 символов

Неверная температура

{
  "detail": [
    {
      "loc": ["body", "temperature"],
      "msg": "Input should be less than or equal to 1",
      "type": "less_than_equal"
    }
  ]
}
Решение: значение temperature от 0 до 1

Автоматические возвраты

При сбое генерации кредиты автоматически возвращаются на ваш аккаунт. Действий не требуется.
Возвраты производятся для:
  • MODERATION_FAILED
  • API_ERROR
  • TASK_FAILED
  • TIMEOUT
Подробности возвратов смотрите в истории транзакций в панели.