Коды ошибок

Коды ошибок

При ошибках вызова API или использования сайта сверяйтесь с этим справочником.

401 Unauthorized

Значение: недействительный API-ключ.

Проверить:

  1. Полностью ли скопирован ключ (начинается с sk-, без лишних пробелов)
  2. Не удалён ли ключ — проверьте в Управлении API-ключами
  3. Активна ли переменная окружения (переоткройте терминал)

403 Forbidden

Значение: нет прав доступа к ресурсу.

Проверить: ключ мог быть отключён или IP ограничен. Проверьте статус в Управлении API-ключами.

404 Not Found

Значение: модель не найдена или неверный путь.

Проверить:

  1. Точно ли совпадает имя модели с каталогом моделей (с учётом регистра)
  2. Включён ли суффикс /v1 в Base URL

429 Too Many Requests

Значение: слишком много запросов — сработало ограничение частоты.

Решение: подождите несколько секунд и повторите; для высокочастотных сценариев добавьте логику повторных попыток в коде.

Недостаточно средств

Значение: баланса аккаунта не хватает для этого вызова.

Решение: пополните на странице пополнения.

500 / 502 / 503

Значение: временная ошибка сервера.

Решение: повторите позже. При постоянных ошибках отправьте тикет через Мои формы.