Mit dieser Anleitung können Sie häufige Probleme diagnostizieren und beheben, die beim Aufrufen der Gemini API auftreten. Wenn Probleme mit einem API-Schlüssel auftreten, prüfen Sie, ob Sie ihn korrekt gemäß der Einrichtungsanleitung für API-Schlüssel eingerichtet haben.
Fehlercodes
Die folgende Tabelle enthält häufige Fehlercodes, die auftreten können, sowie Erläuterungen zu ihren Ursachen und Schritte zur Fehlerbehebung:
| HTTP-Code | Status | Beschreibung | Lösung |
| 400 | INVALID_ARGUMENT | Der Anfragetext ist fehlerhaft. | In der API-Referenz finden Sie Informationen zum Anfrageformat, zu Beispielen und zu unterstützten Versionen. Die Verwendung von Funktionen einer neueren API-Version mit einem älteren Endpunkt kann zu Fehlern führen. |
| 403 | PERMISSION_DENIED | Ihr API-Schlüssel hat nicht die erforderlichen Berechtigungen. | Prüfen Sie, ob Ihr API-Schlüssel festgelegt ist und die richtigen Zugriffsberechtigungen hat. |
| 404 | NOT_FOUND | Die angeforderte Ressource wurde nicht gefunden. | Prüfen Sie, ob alle Parameter in Ihrer Anfrage für die API-Version gültig sind. |
| 429 | RESOURCE_EXHAUSTED | Sie haben die Ratenbegrenzung überschritten. | Achten Sie darauf, dass Sie das Ratenlimit des Modells nicht überschreiten. Fordern Sie bei Bedarf eine Kontingenterhöhung an. |
| 500 | INTERN | Bei Google ist ein unerwarteter Fehler aufgetreten. | Warten Sie einen Moment und versuchen Sie es dann noch einmal. Wenn das Problem nach einem neuen Versuch weiterhin besteht, melden Sie es bitte über die Schaltfläche Feedback geben in Google AI Studio. |
| 503 | UNAVAILABLE | Der Dienst ist möglicherweise vorübergehend überlastet oder ausgefallen. | Warten Sie einen Moment und versuchen Sie es dann noch einmal. Wenn das Problem nach einem neuen Versuch weiterhin besteht, melden Sie es bitte über die Schaltfläche Feedback geben in Google AI Studio. |
API-Aufrufe auf Modellparameterfehler prüfen
Achten Sie darauf, dass Ihre Modellparameter die folgenden Werte enthalten:
| Modellparameter | Werte (Bereich) |
| Teilnehmerzahl | 1–8 (Ganzzahl) |
| Temperatur | 0,0–1,0 |
| Max. Ausgabetokens |
Verwenden Sie get_model (Python), um die maximale Anzahl von Tokens für das von Ihnen verwendete Modell zu ermitteln.
|
| TopP | 0,0–1,0 |
Achten Sie außerdem darauf, dass Sie die richtige API-Version verwenden (z.B. /v1 oder /v1beta) und das Modell, das die von Ihnen benötigten Features unterstützt. Wenn sich eine Funktion beispielsweise in der Betaphase befindet, ist sie nur in der API-Version /v1beta verfügbar.
Prüfen, ob Sie das richtige Modell haben
Achten Sie darauf, dass Sie ein unterstütztes Modell verwenden. Verwenden Sie list_models (Python), um alle Modelle zur Verfügung zu stellen.
Sicherheitsprobleme
Wenn Sie sehen, dass eine Aufforderung aufgrund einer Sicherheitseinstellung in Ihrem API-Aufruf blockiert wurde, prüfen Sie die Aufforderung im Hinblick auf die Filter, die Sie im API-Aufruf festgelegt haben.
Wenn Sie BlockedReason.OTHER sehen, verstößt die Abfrage oder Antwort möglicherweise gegen die Nutzungsbedingungen oder wird anderweitig nicht unterstützt.
Modellausgabe verbessern
Für qualitativ hochwertigere Modellausgaben sollten Sie das Schreiben von strukturierteren Prompts ausprobieren. Auf der Seite Einführung in den Prompt-Entwurf werden einige grundlegende Konzepte, Strategien und Best Practices vorgestellt, um Ihnen den Einstieg zu erleichtern.
Wenn Sie Hunderte von Beispielen für gute Eingabe/Ausgabe-Paare haben, können Sie auch die Modellabstimmung in Betracht ziehen.
Informationen zu Tokenlimits
Verwenden Sie die ModelService API, um zusätzliche Metadaten zu den Modellen abzurufen, einschließlich Limits für Eingabe- und Ausgabetokens.
Verwenden Sie countMessageTokens für Chatmodelle und countTextTokens für Textmodelle, um die Tokens zu erhalten, die von Ihrem Prompt verwendet werden.
Bekannte Probleme
- Unterstützung von Google AI Studio für Mobilgeräte: Sie können die Website zwar auf Mobilgeräten öffnen, sie wurde jedoch nicht für kleine Bildschirme optimiert.
- Die API unterstützt nur Englisch. Wenn Sie Prompts in verschiedenen Sprachen senden, kann dies zu unerwarteten oder sogar blockierten Antworten führen. Aktuelle Informationen finden Sie unter Verfügbare Sprachen.
Fehler melden
Sie können auf GitHub ein Problem melden, Fragen stellen, Funktionsanfragen stellen oder Programmfehler melden.