Gemini API Key验证失败需按五步排查：一、确保Key纯净无空格；二、启用Vertex AI和Generative Language API；三、确认Key绑定项目与调用项目ID一致；四、检查Key限制设置是否允许对应API和来源；五、排除服务账号等认证方式冲突。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您尝试使用Gemini API Key调用服务时收到“无效”或“无法通过验证”的提示，则可能是由于AI Studio中生成的Key尚未激活、配置错误或权限不匹配。以下是核对与修复该问题的具体步骤：
一、确认API Key是否已正确复制
API Key在复制过程中可能混入不可见空格、换行符或中文标点，导致验证失败。需确保获取的是纯净的密钥字符串。
1、登录Google AI Studio控制台，进入“Manage API Keys”页面。
2、点击目标Key右侧的“Copy”按钮（而非手动全选复制）。
3、将复制内容粘贴至纯文本编辑器（如记事本），检查首尾是否有空格、制表符或回车符。
4、仅保留从“AIza...”开始、连续无间断的字符串，重新用于请求头或配置文件。
二、检查项目是否启用Gemini API服务
即使Key已生成，若对应Google Cloud项目未启用Gemini相关API，验证也会被拒绝。必须显式开启对应服务。
1、访问Google Cloud Console，切换至该API Key所属的项目。
2、在左侧导航栏选择“API和服务”→“库”。
3、搜索“Vertex AI API”并点击进入，确认状态为“已启用”；若未启用，点击“启用”按钮。
4、同样搜索并启用“Generative Language API”，二者缺一不可。
三、验证Key绑定的项目与调用项目是否一致
API Key在AI Studio中创建时默认绑定到特定项目，若代码中指定的project_id或调用环境指向其他项目，将触发验证失败。
1、在AI Studio右上角点击项目名称，记录当前显示的项目ID（格式如：my-project-123456）。
2、检查您的请求代码中是否显式设置了project_id参数，确认其值与AI Studio中项目ID完全一致，包括大小写和连字符。
3、若使用curl命令调用，确保URL中包含正确的project_id，例如：https://us-central1-aiplatform.googleapis.com/v1/projects/my-project-123456/locations/us-central1/publishers/google/models/gemini-pro:streamGenerateContent。
四、检查API Key的限制设置
AI Studio允许为Key设置应用限制（HTTP引用、IP地址、API方法等），任意一项不匹配都会导致拒绝验证。
1、在AI Studio的“Manage API Keys”页面，点击目标Key右侧的铅笔图标进入编辑。
2、展开“Application restrictions”部分，确认当前设为“None”或已准确配置允许的来源（如特定域名或IP）。
3、展开“API restrictions”部分，确认已勾选“Restrict key to APIs”，并在下方列表中明确启用“Generative Language API”和“Vertex AI API”。
4、保存更改后，等待约2分钟使策略生效，再重试调用。
五、排查认证方式冲突
若同时在环境中配置了服务账号密钥（JSON文件）或gcloud凭据，系统可能优先使用其他认证方式，导致API Key被忽略或校验路径异常。
1、在终端执行命令：gcloud auth list，查看当前活跃账号是否为预期账号。
2、运行：gcloud config get-value project，确认输出项目ID与AI Studio中一致。
3、临时清除本地凭据：执行gcloud auth revoke --all，然后仅以API Key方式调用，排除干扰。
