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

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 или detail для программной обработки.

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

Проблемы из-за невалидного запроса или нехватки ресурсов.
HTTP-статус: 402 Payment RequiredОписание: Недостаточно кредитов для выполнения запросаРешение: Пополните баланс
{
  "detail": "INSUFFICIENT_CREDITS"
}
HTTP-статус: 404 Not FoundОписание: Задача с указанным UUID не существуетРешение: Проверьте корректность task UUID
{
  "detail": "Task not found"
}
HTTP-статус: 400 Bad RequestОписание: Параметры запроса невалидны или отсутствуют обязательные поляТипичные причины:
  • Длина промпта вне диапазона 1–4000 символов
  • Передано больше 4 изображений
  • Невалидный формат изображения
  • Неподдерживаемая модель
Решение: Проверьте значения и типы параметров
{
  "detail": "Validation error: images format invalid"
}
HTTP-статус: 400 Bad RequestОписание: Одно или несколько изображений не в валидном форматеРешение: убедитесь, что изображения:
  • Валидные HTTP/HTTPS URL
  • Base64 с правильным префиксом MIME-типа
  • Base64 без префикса (декодируется как JPEG)
{
  "detail": "Invalid image format"
}

Полный справочник ошибок

INSUFFICIENT_CREDITS
User Error
Недостаточно кредитов для выполнения запроса (HTTP 402)
OPENAI_DECLINED
System Error
Сервис OpenAI отклонил запрос (HTTP 500, попытка автоматического возврата)
Maintenance
System Error
Сервис временно недоступен из-за обслуживания (HTTP 503)

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

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

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

Проблема: “INSUFFICIENT_CREDITS”

Причина: Баланс аккаунта слишком низкий. Решение:
  • Пополните баланс
  • Проверьте текущий баланс в панели

Проблема: “OPENAI_DECLINED”

Причина: Сервис OpenAI отклонил запрос или произошла внутренняя ошибка. Решение:
  • Сервис автоматически пытается вернуть кредиты
  • Подождите несколько минут и попробуйте снова
  • Если проблема повторяется, свяжитесь с поддержкой с task_uuid

Проблема: “Maintenance”

Причина: Сервис временно отключён для обслуживания. Решение:
  • Дождитесь завершения обслуживания
  • Проверьте страницу статуса или объявления
  • Повторите после окна обслуживания

Проблема: “Invalid image format”

Причина: Изображения переданы в неверном формате. Решение:
  • Используйте валидные HTTP/HTTPS URL
  • Либо Base64 с MIME-префиксом: data:image/jpeg;base64,...
  • Либо plain Base64 (декодируется как JPEG)

Проблема: “More than 4 images”

Причина: Передано больше максимально допустимого количества изображений. Решение:
  • Ограничьте массив images до 4 элементов
  • При необходимости объединяйте несколько изображений
Всегда обрабатывайте ошибки программно по кодам, а не по человекочитаемым сообщениям.