Tipps zur Fehlerbehebung

In dieser Anleitung erfahren Sie, wie Sie häufige Probleme diagnostizieren und beheben, die beim Aufrufen der Gemini API auftreten können. Probleme können entweder im Backend-Dienst der Gemini API oder in den Client-SDKs auftreten. Unsere Client-SDKs sind Open Source und in den folgenden Repositorys verfügbar:

• python-genai
• js-genai
• go-genai

Wenn Sie Probleme mit dem API-Schlüssel haben, prüfen Sie, ob Sie ihn gemäß der Anleitung zum Einrichten von API-Schlüsseln richtig eingerichtet haben.

Gemini API – Backend-Dienstfehlercodes

In der folgenden Tabelle sind häufige Backend-Fehlercodes aufgeführt, die auftreten können, zusammen mit Erklärungen zu ihren Ursachen und Schritten zur Fehlerbehebung:

API-Aufrufe auf Fehler bei Modellparametern prüfen

Prüfen Sie, ob die Parameter Ihres Modells die folgenden Werte einhalten:

Achten Sie nicht nur darauf, dass Sie die richtigen Parameterwerte verwenden, sondern auch die richtige API-Version (z.B. /v1 oder /v1beta) und das richtige Modell, das die benötigten Funktionen unterstützt. Wenn eine Funktion beispielsweise in der Betaphase ist, ist sie nur in der API-Version /v1beta verfügbar.

Prüfen, ob Sie das richtige Modell haben

Prüfen Sie, ob Sie ein unterstütztes Modell verwenden, das auf unserer Seite „Modelle“ aufgeführt ist.

Höhere Latenz oder Tokennutzung bei 2.5-Modellen

Wenn Sie bei den Modellen 2.5 Flash und Pro eine höhere Latenz oder Tokennutzung feststellen, kann das daran liegen, dass Thinking standardmäßig aktiviert ist, um die Qualität zu verbessern. Wenn Sie Geschwindigkeit priorisieren oder Kosten minimieren müssen, können Sie die Denkphase anpassen oder deaktivieren.

Hier finden Sie Anleitungen und Beispielcode.

Sicherheitsprobleme

Wenn ein Prompt aufgrund einer Sicherheitseinstellung in Ihrem API-Aufruf blockiert wurde, überprüfen Sie den Prompt im Hinblick auf die Filter, die Sie im API-Aufruf festgelegt haben.

Wenn Sie BlockedReason.OTHER sehen, verstößt die Anfrage oder Antwort möglicherweise gegen die Nutzungsbedingungen oder wird anderweitig nicht unterstützt.

Problem mit der Rezitation

Wenn das Modell die Ausgabe aufgrund des RECITATION-Grundes beendet, kann es sein, dass die Modellausgabe bestimmten Daten ähnelt. Um dieses Problem zu beheben, sollten Sie den Prompt bzw. Kontext so einzigartig wie möglich gestalten und eine höhere Temperatur verwenden.

Problem mit sich wiederholenden Tokens

Wenn Sie wiederholte Ausgabetokens sehen, können Sie versuchen, sie mit den folgenden Vorschlägen zu reduzieren oder zu eliminieren.

          # 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.
      

Blockierte oder nicht funktionierende API-Schlüssel

In diesem Abschnitt wird beschrieben, wie Sie prüfen, ob Ihr Gemini API-Schlüssel gesperrt ist, und was Sie in diesem Fall tun können.

Gründe für die Sperrung von Schlüsseln

Wir haben eine Sicherheitslücke entdeckt, durch die einige API-Schlüssel öffentlich zugänglich gewesen sein könnten. Zum Schutz Ihrer Daten und zur Verhinderung unbefugten Zugriffs haben wir diese bekannten, offengelegten Schlüssel proaktiv für den Zugriff auf die Gemini API gesperrt.

Prüfen, ob Ihre Schlüssel betroffen sind

Wenn Ihr Schlüssel bekannt ist, können Sie ihn nicht mehr mit der Gemini API verwenden. In Google AI Studio können Sie nachsehen, ob Ihre API-Schlüssel für Aufrufe der Gemini API gesperrt sind, und neue Schlüssel generieren. Möglicherweise wird auch der folgende Fehler zurückgegeben, wenn Sie versuchen, diese Schlüssel zu verwenden:

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

Maßnahmen bei blockierten API-Schlüsseln

Sie sollten neue API-Schlüssel für Ihre Gemini API-Integrationen mit Google AI Studio generieren. Wir empfehlen dringend, Ihre API-Schlüsselverwaltung zu überprüfen, um sicherzustellen, dass Ihre neuen Schlüssel sicher aufbewahrt und nicht öffentlich zugänglich sind.

Unerwartete Kosten aufgrund von Sicherheitslücken

Supportanfrage zur Abrechnung einreichen Unser Abrechnungsteam arbeitet daran und wir werden Sie so bald wie möglich über Neuigkeiten informieren.

Sicherheitsmaßnahmen von Google bei offengelegten Schlüsseln

Wie kann Google mein Konto vor Kostenüberschreitungen und Missbrauch schützen, wenn meine API-Schlüssel offengelegt werden?

• Wir stellen API-Schlüssel künftig nur noch aus, wenn Sie einen neuen Schlüssel über Google AI Studio anfordern. Diese Schlüssel sind standardmäßig auf Google AI Studio beschränkt und akzeptieren keine Schlüssel von anderen Diensten. So wird eine unbeabsichtigte Verwendung von Schlüsseln verhindert.
• Wir blockieren standardmäßig API-Schlüssel, die offengelegt und mit der Gemini API verwendet werden. So können wir Missbrauch von Kosten und Ihren Anwendungsdaten verhindern.
• Den Status Ihrer API-Schlüssel finden Sie in Google AI Studio. Wir werden Sie proaktiv informieren, wenn wir feststellen, dass Ihre API-Schlüssel offengelegt wurden, damit Sie sofort Maßnahmen ergreifen können.

Modellausgabe verbessern

Wenn Sie eine höhere Qualität der Modellausgaben wünschen, sollten Sie strukturiertere Prompts schreiben. Auf der Seite Leitfaden zum Prompt Engineering werden einige grundlegende Konzepte, Strategien und Best Practices vorgestellt, die Ihnen den Einstieg erleichtern.

Informationen zu Tokenlimits

In unserem Leitfaden zu Tokens erfahren Sie mehr darüber, wie Tokens gezählt werden und welche Limits gelten.

Bekannte Probleme

• Die API unterstützt nur eine begrenzte Anzahl von Sprachen. Wenn Sie Prompts in nicht unterstützten Sprachen einreichen, kann das zu unerwarteten oder sogar blockierten Antworten führen. Verfügbare Sprachen

Fehler melden

Wenn Sie Fragen haben, können Sie sich im Google AI-Entwicklerforum an der Diskussion beteiligen.