Ошибки возвращают стабильный код в поле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 — обрабатывайте их программно по кодам, а не по человекочитаемому тексту.
Категории ошибок
- Ошибки пользователя
- Ошибки контента
- Системные ошибки
Проблемы из-за невалидного запроса или нехватки ресурсов.
INSUFFICIENT_CREDITS
INSUFFICIENT_CREDITS
Описание: Недостаточно кредитов для выполнения запросаРешение: Пополните баланс
GENERATION_NOT_FOUND
GENERATION_NOT_FOUND
Описание: Генерация с указанным ID не существуетРешение: Проверьте корректность ID
INVALID_PARAMETERS
INVALID_PARAMETERS
Описание: Параметры запроса невалидны или отсутствуют обязательные поляРешение: Проверьте значения и типы параметров
INVALID_IMAGE
INVALID_IMAGE
Описание: Одно или несколько входных изображений невалидныРешение: Используйте JPEG, PNG, GIF или WEBP
IMAGE_INACCESSIBLE
IMAGE_INACCESSIBLE
Описание: Одно или несколько URL изображений недоступныРешение: Проверьте доступность URL по HTTPS
TOO_MANY_IMAGES
TOO_MANY_IMAGES
Описание: Передано больше 5 изображенийРешение: Ограничьте количество до 5 на запрос
MIXED_IMAGE_INPUTS
MIXED_IMAGE_INPUTS
Описание: В одном запросе переданы и
images_url, и images_base64Решение: Используйте только один способ передачи изображенийINVALID_DURATION
INVALID_DURATION
Описание: Длительность вне допустимых значений (5, 10, 15)Решение: Используйте одно из поддерживаемых значений
INVALID_MODEL
INVALID_MODEL
Описание: Модель не равна ‘kling_o3’ или ‘kling_o3_pro’Решение: Используйте ‘kling_o3’ для Standard или ‘kling_o3_pro’ для Pro
Справочник HTTP-кодов
Генерация создана успешно
Запрос выполнен успешно
Невалидные параметры или формат запроса
Невалидный или отсутствующий API-ключ
Недостаточно кредитов
Генерация не найдена
Невалидный формат ввода или отсутствуют обязательные поля
Ошибка на стороне сервера
Сервис временно недоступен
Типичные проблемы и решения
Почему генерация падает сразу?
Почему генерация падает сразу?
Возможные причины:
- Промпт содержит запрещённый контент
- Невалидный формат изображения или повреждённый файл
- URL изображений недоступны
- Смешаны
images_urlиimages_base64
- Проверьте payload webhook на конкретный код ошибки
- Убедитесь, что все изображения доступны
- Используйте только один способ передачи изображений
- Пересмотрите правила контента
Генерация слишком долгая?
Генерация слишком долгая?
Нормальная хронология:
- 5s Standard: 2–3 минуты
- 10s Standard: 3–5 минут
- 15s Standard: 5–7 минут
- Pro-режим: +30–50% времени
Кредиты списаны, а видео нет?
Кредиты списаны, а видео нет?
Если генерация неудачна: кредиты автоматически возвращаются в течение 5 минутЕсли успешна, но нет URL: проверьте эндпоинт статуса — возможно, webhook не доставленДля проверки: используйте
GET /v1/kling/o3-video/generations/{generation_id}Ошибки с изображениями?
Ошибки с изображениями?
Типичные ошибки:
- Использование одновременно
images_urlиimages_base64(выберите одно) - Больше 5 изображений
- Изображения больше 10 MB
- Невалидные форматы (используйте JPEG, PNG, GIF, WEBP)
- Изображения недоступны по HTTPS
Какую модель выбрать?
Какую модель выбрать?
Standard (kling_o3) — 720p:
- Быстрее генерация (2–5 мин)
- Ниже стоимость
- Хорошо для соцсетей и превью
- Меньшее разрешение
- Выше качество
- Подходит для профессионального использования
- Медленнее (+30–50% времени)
- Дороже (~в 2 раза)
Примеры обработки ошибок
Руководство по диагностике
Проверьте логи webhook
Если используете webhooks, проверьте логи сервера на подробную информацию об ошибках