google · Google AI Docs

Gemini API Troubleshooting guide

A collection of common error scenarios, troubleshooting steps, and diagnostic paths for resolving issues encountered while using the Gemini API.

Derived skill

Files assembled from official documentation

Viewing SKILL.md

A collection of common error scenarios, troubleshooting steps, and diagnostic paths for resolving issues encountered while using the Gemini API.

Use when you encounter specific error codes, unexpected API behaviors, or connectivity issues while implementing the Gemini API.

File	Contains	Use For
`SKILL.md`	Entry point: scope, routing table, and workflow.	Start here.
`docs/gemini-api-troubleshooting-guide-workflow-guide.md`	A guide for diagnosing and resolving common Gemini API backend service errors, model parameter issues, and latency concerns.	Questions about a guide for diagnosing and resolving common Gemini API backend service errors, model parameter issues, and latency co...
`examples/gemini-api-troubleshooting-guide-gemini-api-leaked-key-error-message.text`	A text representation of the error message received when a Gemini API key has been reported as leaked.	Exact payloads, commands, or snippets shown in A text representation of the error message received when a Gemini API key has been reported as leaked.

Use this guide to help you diagnose and resolve common issues that arise when you call the Gemini API. You may encounter issues from either the Gemini API ba...
Main sections: Gemini API backend service error codes, Check your API calls for model parameter errors, Check if you have the right model, Higher latency or token usage with 2.5 models, Safety issues.

Open the most relevant file under docs/ for the exact documented workflow and wording.
Open schemas/ files for exact structured contracts.
Open examples/ files for concrete requests, commands, snippets, and manifests.
Do not add behavior or configuration that is not present in the attached source files.