Руководство по устранению неполадок

Это руководство поможет вам диагностировать и устранять распространенные проблемы, возникающие при вызове API Gemini. Проблемы могут возникать как в бэкэнде API Gemini, так и в клиентских SDK. Наши клиентские SDK находятся в открытом доступе в следующих репозиториях:

• python-genai
• js-genai
• го-генай

Если у вас возникли проблемы с ключом API, убедитесь, что вы правильно настроили свой ключ API в соответствии с руководством по настройке ключа API .

Коды ошибок бэкэнд-сервиса Gemini API

В таблице ниже перечислены распространенные коды ошибок на стороне сервера, с которыми вы можете столкнуться, а также пояснения к их причинам и шаги по устранению неполадок:

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

Убедитесь, что параметры вашей модели находятся в пределах следующих значений:

Помимо проверки значений параметров, убедитесь, что вы используете правильную версию API (например, /v1 или /v1beta ) и модель, поддерживающую необходимые вам функции. Например, если функция находится в бета-версии, она будет доступна только в версии API /v1beta .

Проверьте, подходит ли вам данная модель.

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

Более высокая задержка или использование токенов в моделях 2.5

Если вы наблюдаете повышенную задержку или расход токенов на моделях Flash и Pro с прошивкой 2.5, это может быть связано с тем, что функция «мышления» включена по умолчанию для повышения качества. Если для вас важна скорость или минимизация затрат, вы можете настроить или отключить функцию «мышления».

Для получения рекомендаций и примеров кода обратитесь к странице с описанием процесса мышления .

Вопросы безопасности

Если вы видите, что запрос был заблокирован из-за настроек безопасности в вашем вызове API, проверьте запрос на соответствие фильтрам, которые вы установили в вызове API.

Если вы видите BlockedReason.OTHER , это означает, что запрос или ответ могут нарушать условия предоставления услуг или быть неподдерживаемыми по другим причинам.

Вопрос о декламации

Если вы видите, что модель перестает генерировать выходные данные по причине RECITATION, это означает, что выходные данные модели могут быть похожи на определенные данные. Чтобы исправить это, попробуйте сделать подсказку/контекст максимально уникальными и используйте более высокую температуру.

Повторная выдача токенов

Если вы видите повторяющиеся выходные токены, попробуйте следующие рекомендации, чтобы уменьшить или устранить их.

          # Markdown Table Format
          
          * Separator line: Markdown tables must include a separator line below
            the header row. The separator line must use only 3 hyphens per
            column, for example: |---|---|---|. Using more hypens like
            ----, -----, ------ can result in errors. Always
            use |:---|, |---:|, or |---| in these separator strings.

            For example:

            | Date | Description | Attendees |
            |---|---|---|
            | 2024-10-26 | Annual Conference | 500 |
            | 2025-01-15 | Q1 Planning Session | 25 |

          * Alignment: Do not align columns. Always use |---|.
            For three columns, use |---|---|---| as the separator line.
            For four columns use |---|---|---|---| and so on.

          * Conciseness: Keep cell content brief and to the point.

          * Never pad column headers or other cells with lots of spaces to
            match with width of other content. Only a single space on each side
            is needed. For example, always do "| column name |" instead of
            "| column name                |". Extra spaces are wasteful.
            A markdown renderer will automatically take care displaying
            the content in a visually appealing form.
        

        When thinking silently: ALWAYS start the thought with a brief
        (one sentence) recap of the current progress on the task. In
        particular, consider whether the task is already done.
      

Заблокированные или неработающие ключи API

В этом разделе описано, как проверить, заблокирован ли ваш API-ключ Gemini, и что с этим делать.

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

Мы выявили уязвимость, из-за которой некоторые ключи API могли быть публично доступны. Для защиты ваших данных и предотвращения несанкционированного доступа мы заблаговременно заблокировали доступ к API Gemini для этих известных утечек ключей.

Уточните, затронуты ли ваши ключи.

Если известно, что ваш ключ был скомпрометирован, вы больше не сможете использовать его с API Gemini. Вы можете использовать Google AI Studio, чтобы проверить, заблокированы ли какие-либо из ваших ключей API для вызова API Gemini, и сгенерировать новые ключи. При попытке использования этих ключей вы также можете увидеть следующую ошибку:

Your API key was reported as leaked. Please use another API key.

Действия в случае блокировки ключей API

Для интеграции с Gemini API следует генерировать новые ключи API с помощью Google AI Studio . Мы настоятельно рекомендуем пересмотреть ваши методы управления ключами API, чтобы убедиться в безопасности новых ключей и предотвратить их публичное раскрытие.

Непредвиденные расходы из-за уязвимости

Отправьте запрос в службу поддержки по вопросам выставления счетов . Наша команда по вопросам выставления счетов работает над этим, и мы сообщим вам о результатах как можно скорее.

Меры безопасности Google в отношении утечек ключей

Как Google собирается защитить мой аккаунт от перерасхода средств и злоупотреблений, если мои API-ключи будут скомпрометированы?

• Мы переходим к выдаче API-ключей при запросе нового ключа через Google AI Studio. По умолчанию эти ключи будут доступны только через Google AI Studio и не будут приниматься от других сервисов. Это поможет предотвратить непреднамеренное использование ключей разных сервисов.
• По умолчанию мы блокируем ключи API, которые были скомпрометированы и использованы с API Gemini, что помогает предотвратить злоупотребления в отношении стоимости и данных вашего приложения.
• Вы сможете отслеживать статус своих API-ключей в Google AI Studio , и мы будем заблаговременно сообщать вам о случаях утечки ваших API-ключей для принятия незамедлительных мер.

Улучшить результаты работы модели.

Для получения более качественных результатов моделирования изучите возможность написания более структурированных запросов. На странице руководства по разработке запросов представлены основные понятия, стратегии и лучшие практики, которые помогут вам начать работу.

Ознакомьтесь с ограничениями по токенам.

Ознакомьтесь с нашим руководством по токенам , чтобы лучше понять, как подсчитывать токены и каковы их лимиты.

Известные проблемы

• API поддерживает только ряд ограниченного числа языков. Отправка запросов на неподдерживаемых языках может привести к неожиданным или даже заблокированным ответам. Для получения информации об обновлениях смотрите раздел «Доступные языки» .

Сообщить об ошибке

Если у вас есть вопросы, присоединяйтесь к обсуждению на форуме разработчиков Google AI .