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

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": "INSUFFICIENT_CREDITS"
}
Описание: Генерация с указанным ID не существуетРешение: Проверьте корректность ID
{
  "detail": "Generation not found"
}
Описание: Длительность недоступна в выбранном режиме генерацииРешение: Используйте "5" или "10" для text-to-video, либо передайте изображения для других длительностей
{
  "detail": "Duration 3 seconds is only available for image-to-video generation"
}
Описание: Одно или несколько входных изображений невалидныРешение: Используйте JPEG, PNG или WEBP до 10MB
{
  "status": "failed",
  "message": "INVALID_IMAGE"
}
Описание: URL одного или нескольких изображений вернули 404 или 403Решение: Проверьте публичную доступность всех URL
{
  "status": "failed",
  "message": "IMAGE_INACCESSIBLE"
}
Описание: Передано больше 5 изображенийРешение: Ограничьте количество до 5 на запрос
{
  "detail": "Maximum 5 images allowed"
}

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

INSUFFICIENT_CREDITS
User Error
Недостаточно кредитов для выполнения запроса
CONTENT_POLICY_VIOLATION
Content Error
Контент нарушает правила (18+, насилие, запрещённое содержимое)
IMAGE_INACCESSIBLE
User Error
Одно или несколько URL изображений недоступны (404, 403)
INVALID_IMAGE
User Error
Формат изображения невалиден или файл повреждён
TIMEOUT
System Error
Превышено максимальное время обработки (15 минут)
TASK_FAILED
System Error
Генерация не удалась из-за системной ошибки
MAINTENANCE
System Error
Сервис временно недоступен

Справочник 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
Сервис временно недоступен

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

Проблема: “Duration X seconds is only available for image-to-video”

Причина: Использование длительности "3", "4", "6", "7", "8" или "9" без изображений. Решение:
  • Используйте "5" или "10" для text-to-video
  • Либо передайте изображения для других длительностей

Проблема: ошибка “IMAGE_INACCESSIBLE”

Причина: Переданные images_urls вернули 404 или 403. Решение:
  • Проверьте публичную доступность URL
  • Убедитесь, что URL не требуют авторизации
  • Используйте images_base64, если URL приватные

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

Причина: AI обнаружил запрещённый контент (18+, насилие и т.д.) Решение:
  • Пересмотрите и измените промпт
  • Проверьте входные изображения
  • Избегайте откровенных или жёстких описаний

Проблема: генерация застряла в “pending”

Причина: Воркеры перегружены или сервис под высокой нагрузкой. Решение:
  • Подождите 1–2 минуты, статус должен смениться на “processing”
  • Если задача висит >5 минут, обратитесь в поддержку с generation_id
Всегда обрабатывайте ошибки программно по кодам, а не по человекочитаемым сообщениям.