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

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 — обрабатывайте их программно по кодам, а не по человекочитаемому тексту.

​
Категории ошибок

Проблемы из-за невалидного запроса или нехватки ресурсов.
Описание: Недостаточно кредитовРешение: Пополните баланс
{
  "success": false,
  "message": "INSUFFICIENT_CREDITS"
}
Описание: Генерация с указанным ID не существуетРешение: Проверьте корректность ID
{
  "detail": "Generation not found"
}
Описание: Параметры запроса невалидны или отсутствуют обязательные поляРешение: Проверьте значения и типы параметров
{
  "detail": "Validation error: prompt is required"
}
Описание: Одно или несколько входных изображений невалидныРешение: Используйте JPEG, PNG или WEBP
{
  "status": "failed",
  "message": "INVALID_IMAGE"
}
Описание: Одно или несколько URL изображений недоступныРешение: Проверьте доступность URL по HTTPS
{
  "status": "failed",
  "message": "IMAGE_INACCESSIBLE"
}
Описание: Невалидное разрешение (должно быть 1k, 2k или 4k)Решение: Используйте одно из поддерживаемых значений
{
  "detail": "Invalid resolution. Must be 1k, 2k, or 4k"
}
Описание: Передано больше 10 изображенийРешение: Ограничьте до 10 на запрос
{
  "detail": "Maximum 10 images allowed (URLs + base64 combined)"
}
Описание: Переданы и images_url, и images_base64Решение: Используйте только один способ
{
  "detail": "Cannot mix images_url and images_base64 in one request"
}

​
Справочник HTTP-кодов

​
201
Created
Генерация создана успешно
​
200
OK
Запрос выполнен успешно
​
400
Bad Request
Невалидные параметры или формат запроса
​
401
Unauthorized
Невалидный или отсутствующий API-ключ
​
402
Payment Required
Недостаточно кредитов
​
404
Not Found
Генерация не найдена
​
422
Validation Error
Невалидный формат ввода или отсутствуют обязательные поля
​
500
Internal Server Error
Ошибка на стороне сервера
​
503
Service Unavailable
Сервис временно недоступен

​
Типичные проблемы и решения

Возможные причины:
  • Промпт содержит запрещённый контент
  • Невалидный формат или повреждённый файл изображения
  • URL изображений недоступны
Решение: проверьте payload webhook на конкретный код ошибки
Нормальная хронология:
  • Простое text-to-image: 1–2 минуты
  • С референсами: 2–3 минуты
  • Разрешение 4K: может занять дольше
Если превышает 5 минут: проверьте эндпоинт статуса или дождитесь webhook
Если генерация неудачна: кредиты возвращаются автоматически в течение 5 минутЕсли успешна, но нет URL: проверьте эндпоинт статуса — webhook мог не доставиться