问题排查指南

借助本指南，您可以诊断和解决您需要调用 Gemini API。如果您遇到 API 密钥问题，请确保您已设置按照 API 密钥设置指南正确设置您的 API 密钥。

错误代码

下表列出了您可能遇到的常见错误代码原因说明和问题排查步骤：

HTTP 代码	状态	说明	解决方案
400	INVALID_ARGUMENT	请求正文格式不正确。	如需了解请求格式、示例和支持的版本，请参阅 API 参考文档。将新版 API 与旧版端点中的功能搭配使用可能会导致错误。
400	FAILED_PRECONDITION	Gemini API 免费层级未在您所在的国家/地区推出。请在 Google AI Studio 中为您的项目启用结算功能。	如需使用 Gemini API，您需要使用 Google AI Studio 设置付费方案。
403	PERMISSION_DENIED	您的 API 密钥不具备所需的权限。	请检查您的 API 密钥是否已设置且拥有适当的访问权限。
404	NOT_FOUND	找不到请求的资源。	检查请求中的所有参数是否对您的 API 版本有效。
429	RESOURCE_EXHAUSTED	您已超出速率限制。	确保不超过模型的速率限制。根据需要申请增加配额。
500	INTERNAL	Google 端出现意外错误。	请稍等片刻，然后重试您的请求。如果重试后问题仍然存在，请使用 Google AI Studio 中的发送反馈按钮报告该问题。
503	UNAVAILABLE	服务可能暂时过载或关闭。	请稍等片刻，然后重试您的请求。如果重试后问题仍然存在，请使用 Google AI Studio 中的发送反馈按钮报告该问题。

确保您的模型参数在以下值范围内：

模型参数	值（范围）
候选人数量	1-8（整数）
体温	0.0-1.0
输出词元数量上限	使用 `get_model` (Python) 以确定您正在使用的模型的词元数量上限。
TopP	0.0-1.0

除了检查参数值外，还要确保使用的是正确的 API 版本（例如，/v1 或 /v1beta）和模型。例如，如果某个功能处于 Beta 版阶段版本，将仅支持 /v1beta API 版本。

确保您使用的是我们的模型页面。

如果您看到由于 API 调用中的安全设置而导致提示被屏蔽，查看与您在 API 调用中设置的过滤条件有关的提示。

如果您看到 BlockedReason.OTHER，说明查询或响应可能违反了条款或不受服务支持。

如需获得更高质量的模型输出，不妨尝试编写更多结构化提示。通过提示设计简介页面一些基本概念、策略和最佳做法，以帮助您快速入门。

如果您有数百个良好输入/输出对样本，考虑模型调优。

仔细阅读令牌指南，更好地了解来统计词元数量及其上限。