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