Ошибки Kling API: коды, причины и решения

Диагностика ошибок Kling API через NexusAPI: 401, 402, 422, 429, 5xx, failed-задачи, безопасные повторы и данные для обращения в поддержку.

HTTP-ошибка или failed-задача

Если POST /generate вернул ошибочный HTTP-код, задача могла не быть создана. Если task_id уже получен, а GET /tasks/{task_id} вернул status failed, изучите поле error. Эти два случая требуют разной диагностики.

401 означает проблему с Bearer-токеном. При 402 проверьте баланс. Ответ 422 означает несоответствие тела схеме: проверьте вложенность params, model_name, обязательные поля, типы значений, длительность и количество референсов. Такие запросы нельзя исправить повтором без изменения причины.

Контролируемые повторы

При 429 уменьшите частоту и добавьте задержку. Для временной ошибки 5xx допустим ограниченный retry с экспоненциальной паузой и случайным jitter. Не запускайте бесконечные повторы и не создавайте вторую задачу, пока не проверили, был ли получен task_id.

Для обращения в поддержку сохраните endpoint, HTTP-метод, ID модели, безопасный фрагмент params, task_id, HTTP-код, текст ошибки и примерное время запроса. Никогда не отправляйте API-ключ и персональные данные. Сверьте выбранную Kling-схему с актуальным OpenAPI JSON.