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

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

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

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

Коды ошибок бэкэнд-службы API Gemini

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

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

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

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

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

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

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

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

Инструкции и пример кода см. на странице размышлений .

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

Если вы видите, что запрос заблокирован из-за настроек безопасности в вызове 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 поддерживает только несколько языков. Отправка запросов на неподдерживаемых языках может привести к неожиданным или даже заблокированным ответам. Следите за обновлениями в списке доступных языков .

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

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