Типичные ошибки и восстановление

Сначала запишите HTTP-статус и путь запроса.

401 Нет аутентификации

Key отсутствует, неактивен, скопирован не полностью или отправлен с неверным заголовком.

Скопируйте Key заново, удалите пробелы и проверьте Bearer, x-api-key либо x-goog-api-key.

Текущий Key, состояние учётной записи или доступ к модели не разрешают запрос.

Убедитесь, что Key активен, и выберите доступную модель на странице моделей и цен.

Base URL, путь протокола или HTTP-метод не совпадают; клиент мог дважды добавить /v1.

Сверьте полный метод и путь с руководством и укажите только требуемый уровень Base URL.

Запросы идут слишком часто либо текущего доступного остатка недостаточно.

Уменьшите параллельность, повторяйте с растущей задержкой и проверьте состояние учётной записи на портале.

Внешний сервис или шлюз временно не может выполнить запрос.

Сохраните время и статус и повторите позже. При постоянной ошибке выполните минимальный curl для проверки клиента.

Локальная сеть, прокси или длительное соединение закрылись до завершения ответа.

Проверьте доступ к домену, переподключайте потоки с задержкой и не повторяйте автоматически неидемпотентные операции.

Сохраните время, протокол, HTTP-метод, путь, статус и очищенный фрагмент ответа. Не прикладывайте полный Key.