Gemini 常见问题

问题 1：认证方式与 OpenAI 模式有什么差异

问题描述

同样是 API Key，Gemini 相关客户端有时能连，有时报认证错误。

原因分析

不同客户端读取的环境变量和配置文件字段并不完全一致。

解决步骤

1. 明确你使用的是“Gemini CLI”还是“OpenAI 兼容客户端模式”。
2. Gemini CLI 按其配置文件要求设置 GEMINI_API_KEY 等字段。
3. OpenAI 兼容客户端按 base_url + api_key + model 方式配置。
4. 令牌统一使用 Gemini 相关分组，避免分组错配。

问题 2：区域或网络限制导致调用失败

问题描述

在部分网络环境下请求失败、超时或不稳定。

原因分析

• 本地网络对目标链路可达性差。
• 代理链路不稳定导致请求中断。

解决步骤

1. 先用模型列表接口做基础连通性验证。
2. 关闭不必要代理后重试。
3. 在稳定网络环境下执行长任务。
4. 若是团队环境，统一网络出口策略。

问题 3：图像输入支持不稳定

问题描述

文本请求正常，但图像输入场景经常失败或体验不稳定。

原因分析

• 客户端对多模态能力支持程度不同。
• 上传格式、大小或参数不符合客户端要求。

解决步骤

1. 优先使用明确支持多模态的客户端。
2. 控制图像大小与格式，避免超限。
3. 先做小图验证，再批量处理。
4. 若 CLI 体验不稳定，可切换到图形化客户端完成图像任务。

问题 4：计费与配额怎么看

问题描述

用户不确定 Gemini 请求为什么扣费变化较大。

原因分析

• 分组倍率不同导致实际扣费不同。
• 输入输出规模差异大，单次成本波动明显。

解决步骤

1. 在钱包页确认余额和消耗记录。
2. 在模型广场核对当前分组倍率。
3. 将测试与生产令牌分离，便于成本追踪。
4. 按任务类型设置不同分组和预算。

更多细节见 Gemini CLI 教程。