Используйте это руководство, чтобы помочь вам диагностировать и решать распространенные проблемы, возникающие при вызове API Gemini. Если у вас возникли проблемы с ключом API, убедитесь, что вы правильно настроили ключ API в соответствии с руководством по настройке ключа API .
Коды ошибок
В следующей таблице перечислены распространенные коды ошибок, с которыми вы можете столкнуться, а также объяснения их причин и действий по устранению неполадок:
| HTTP-код | Положение дел | Описание | Решение |
| 400 | НЕДЕЙСТВИТЕЛЬНЫМ АРГУМЕНТ | Тело запроса имеет неверный формат. | Проверьте справочник API , чтобы узнать формат запроса, примеры и поддерживаемые версии. Использование функций более новой версии API со старой конечной точкой может привести к ошибкам. |
| 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 .
Проверьте, подходит ли вам модель
Убедитесь, что вы используете поддерживаемую модель. Используйте list_models ( Python ), чтобы получить все модели, доступные для использования.
Вопросы безопасности
Если вы видите, что запрос был заблокирован из-за настройки безопасности в вашем вызове API, просмотрите запрос на предмет фильтров, которые вы установили в вызове API.
Если вы видите BlockedReason.OTHER , запрос или ответ могут нарушать условия обслуживания или не поддерживаться иным образом.
Улучшение вывода модели
Для получения более качественных результатов модели попробуйте писать более структурированные подсказки. Введение в страницу дизайна подсказок знакомит с некоторыми базовыми концепциями, стратегиями и лучшими практиками, которые помогут вам начать работу.
Если у вас есть сотни примеров хороших пар ввода/вывода, вы также можете рассмотреть возможность настройки модели .
Понимание ограничений токенов
Используйте API ModelService , чтобы получить дополнительные метаданные о моделях, включая ограничения входных и выходных токенов.
Чтобы получить токены, используемые вашим приглашением, используйте countMessageTokens для моделей чата и countTextTokens для текстовых моделей.
Известные вопросы
- Поддержка Google AI Studio на мобильных устройствах. Хотя вы можете открыть веб-сайт на мобильных устройствах, он не оптимизирован для маленьких экранов.
- API поддерживает только английский язык. Отправка запросов на разных языках может привести к неожиданным или даже заблокированным ответам. См. доступные языки для получения обновлений.
Сообщить об ошибке
Сообщите о проблеме в Github, чтобы задать вопросы или отправить запросы на функции или ошибки.