Используйте это руководство, чтобы помочь вам диагностировать и решать распространенные проблемы, возникающие при вызове API Gemini. Если у вас возникли проблемы с ключом API, убедитесь, что вы правильно настроили ключ API в соответствии с руководством по настройке ключа API .
Коды ошибок
В следующей таблице перечислены распространенные коды ошибок, с которыми вы можете столкнуться, а также объяснения их причин и действий по устранению неполадок:
| HTTP-код | Положение дел | Описание | Решение |
| 400 | НЕДЕЙСТВИТЕЛЬНЫМ АРГУМЕНТ | Тело запроса имеет неверный формат. | Проверьте справочник API , чтобы узнать формат запроса, примеры и поддерживаемые версии. Использование функций более новой версии API со старой конечной точкой может привести к ошибкам. |
| 400 | FAILED_PRECONDITION | Уровень бесплатного пользования Gemini API недоступен в вашей стране. Пожалуйста, включите оплату для вашего проекта в Google AI Studio. | Чтобы использовать Gemini API, вам необходимо настроить платный план с помощью Google AI Studio . |
| 403 | ДОСТУП ЗАПРЕЩЕН | Ваш ключ API не имеет необходимых разрешений. | Убедитесь, что ваш ключ API установлен и имеет правильный доступ. |
| 404 | НЕ НАЙДЕНО | Запрошенный ресурс не найден. | Проверьте, все ли параметры в вашем запросе действительны для вашей версии API. |
| 429 | RESOURCE_EXHAUSTED | Вы превысили лимит скорости. | Убедитесь, что вы находитесь в пределах лимита скорости , установленного моделью. При необходимости запросите увеличение квоты . |
| 500 | ВНУТРЕННИЙ | На стороне Google произошла непредвиденная ошибка. | Подождите немного и повторите запрос. Если проблема не устранена после повторной попытки, сообщите об этом, используя кнопку «Отправить отзыв» в Google AI Studio. |
| 503 | НЕДОСТУПЕН | Служба может быть временно перегружена или отключена. | Подождите немного и повторите запрос. Если проблема не устранена после повторной попытки, сообщите об этом, используя кнопку «Отправить отзыв» в Google AI Studio. |
Проверьте вызовы API на наличие ошибок параметров модели.
Убедитесь, что параметры вашей модели находятся в пределах следующих значений:
| Параметр модели | Значения (диапазон) |
| Количество кандидатов | 1-8 (целое) |
| Температура | 0,0-1,0 |
| Максимальное количество токенов вывода | Используйте get_model ( Python ), чтобы определить максимальное количество токенов для используемой вами модели. |
| ТопП | 0,0-1,0 |
Помимо проверки значений параметров, убедитесь, что вы используете правильную версию API (например, /v1 или /v1beta ) и модель, которая поддерживает необходимые вам функции. Например, если функция находится в бета-версии, она будет доступна только в версии API /v1beta .
Проверьте, подходит ли вам модель
Убедитесь, что вы используете поддерживаемую модель, указанную на нашей странице моделей .
Вопросы безопасности
Если вы видите, что запрос был заблокирован из-за настройки безопасности в вашем вызове API, проверьте запрос на предмет фильтров, которые вы установили в вызове API.
Если вы видите BlockedReason.OTHER , запрос или ответ могут нарушать условия обслуживания или не поддерживаться иным образом.
Улучшение вывода модели
Для получения более качественных результатов модели попробуйте писать более структурированные подсказки. Введение в страницу дизайна подсказок знакомит с некоторыми базовыми концепциями, стратегиями и лучшими практиками, которые помогут вам начать работу.
Если у вас есть сотни примеров хороших пар ввода/вывода, вы также можете рассмотреть возможность настройки модели .
Понимание ограничений токенов
Прочтите наше руководство по токенам, чтобы лучше понять, как считать токены и их ограничения.
Известные вопросы
- API поддерживает только английский язык. Отправка запросов на разных языках может привести к неожиданным или даже заблокированным ответам. См. доступные языки для получения обновлений.
Сообщить об ошибке
Если у вас есть вопросы, присоединяйтесь к обсуждению на форуме разработчиков Google AI .