认证方式
使用 LinkAGI API Key 时，不要让客户端继续沿用 Google 账号登录流程。
先把三个关键变量分开
同一个错误可能由不同层级触发。按地址、认证、模型或并发逐层验证，比同时修改所有配置更容易定位原因。
模型权限
确认 Key 分组允许当前 Gemini 模型，并从模型广场复制完整名称。
地址规则
Gemini CLI 使用根地址，由客户端继续拼接 /v1beta/models/...。
三步完成最小验证
保留一个可复现的短请求，每次只修改一个变量，并记录返回状态。
清理冲突认证
检查是否同时设置 Google 登录凭据与自定义 API Key，确保当前流程明确。
核对环境变量
确认 Base URL、GEMINI_API_KEY 和模型变量由同一启动环境读取。
更换短请求验证
使用短文本请求排除内容或工具调用限制，再查看日志与错误详情。
Gemini CLI 环境变量示例
export GOOGLE_GEMINI_BASE_URL="https://api.linktoagi.com"
export GEMINI_API_KEY="sk-替换成你的Key"
export GEMINI_MODEL="从控制台复制当前模型名"API Key 只放在环境变量或客户端密钥字段中，不要写进公开仓库、截图或前端代码。模型名与价格请从 LinkAGI 实时模型广场复制。
结果出现后，下一步看什么
不要把所有失败都归因到“中转站不稳定”。先判断请求停在路径、认证、模型、速率还是超时层。
401 而不是 403
优先检查 Key 是否有效；401 更接近认证失败，403 更接近权限或策略拒绝。
只有特定模型 403
检查模型分组、区域或上游策略，并用另一个已授权模型完成对照。
配置后仍走 Google 登录
确认客户端认证模式与启动环境，必要时清理旧会话后重新启动。
地址末尾带 /v1
Gemini 原生路由由客户端拼接，额外 /v1 可能导致路径错误而不是权限错误。
LinkAGI 场景
使用 api.linktoagi.com 接入后，可以在控制台调用日志中核对模型、Token、状态和扣费；遇到持续异常可携带时间与请求信息联系支持，但不要发送完整 API Key。
常见问题
403 是否说明 API Key 无效？
不一定。无效 Key 常见为 401；403 更可能与模型权限、分组或安全策略有关。
Gemini CLI 能否使用 OpenAI 的 /v1 地址？
按 LinkAGI Gemini 原生接入规则使用根地址，由客户端拼接 v1beta 路由。
怎样确认当前模型是否可用？
从实时模型广场复制名称，用独立 Key 和短请求验证，并查看调用日志。
继续排查相关问题
OpenAI API 中转站
OpenAI API 国内接入：Base URL、Key 与首次请求一次配置
如果现有代码已经使用 OpenAI SDK，迁移到 LinkAGI 通常只需要替换 Base URL 与 API Key。真正容易出错的不是代码主体，而是地址层级、模型名和密钥分组。
AI API 504 Gateway TimeoutAI API 返回 504：上游没坏，也可能卡在首字节和代理超时
504 表示某一层网关没有在规定时间内拿到下游响应。上游控制台显示正常，并不能排除单请求首字节过慢、边缘代理超时、非流式长任务或客户端提前断开。
Claude Code model not foundClaude Code 提示 Model Not Found：模型名正确还不够
模型不存在可能是拼写或版本后缀错误，也可能是令牌分组没有该模型、号池临时不可用，或者客户端仍在读取旧环境变量。排查时不要只反复改名字。
先用短请求验证 LinkAGI
注册赠送 ¥0.2 试用额度；模型、号池和价格以实时页面为准。