Gemini CLI 中转站怎么用?59API 首次接入FAQ
第一次用 Gemini CLI,会不会一开始就配错?
第一次打开 Gemini CLI,最容易卡住的地方往往不是模型,而是地址、密钥和协议三件事对不上。换一个中转站如果照抄别人的配置,常见结果是请求超时、鉴权失败,或者接口返回一串看不懂的错误。59API 的思路很直接:它是一个独立的第三方 AI API 中转服务,一个账号对应一把 API key、一个 API 主机地址 https://api.59api.com,Claude、GPT、Gemini、DeepSeek 等模型都可以走同一套账户体系。
但“同一套账户”并不等于“同一个接口”。Gemini 模型只使用 Google 的原生协议,也就是 Gemini CLI 这条路径;它们不是 OpenAI 兼容接口,不会出现在 /v1/chat/completions 上。把 Gemini 塞进 cURL 或者 OpenAI SDK 的调用方式里,请求格式对不上,报错几乎是必然的。
所以起步时先别急着充值,而是先想清楚你要调用哪个模型、它在哪个客户端里运行。Gemini 归 Gemini CLI,Claude 归真正的 Claude Code 或 Claude Desktop,GPT、DeepSeek 等归 Codex、OpenAI SDK、cURL 和 OpenAI 兼容客户端。把这条线分清楚,后面的配置就只是填空题。
Gemini CLI 的配置到底要填哪几项?
路线确认之后,Gemini CLI 的接入其实很短。你需要准备两个环境变量:GOOGLE_GEMINI_BASE_URL 指向 https://api.59api.com,GEMINI_API_KEY 填入你的 59API 密钥,也就是 YOUR_59API_KEY 那个位置对应的真实内容。不要在地址后面追加 /v1,也不要自己拼 /v1/chat/completions,Gemini CLI 会按 Google 原生协议组织请求。
密钥从 59API 账户里获取,一个账号一把 key,既能用于 Gemini CLI,也能用于同一账号下的其他模型调用,前提是协议匹配。设置完成后重启终端让环境变量生效,再在 Gemini CLI 里发起一次最简单的对话。如果这一步能正常返回内容,说明地址和鉴权都已经打通,接下来就可以进入真实使用阶段。
这里也提醒一个常见误区:不要把 Claude 的接入方式套到 Gemini CLI 上。Claude 模型只能通过正版的 Claude Code 或 Claude Desktop 客户端使用,版本要求是 Claude Code 2.1.285 或更新版本,它用的是 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 两项设置,变量名与 Gemini CLI 完全不同。两套配置各自独立,别互相套用,也别把地址混着填。
钱是怎么算的?先看这几个 Gemini 价格
跑通之后,接下来就是钱怎么算。59API 采用预付余额模式,按请求的真实 token 用量计费,没有月费,余额不过期。价格以每 100 万 token 计价,账单以人民币结算。下面几档可以直接对照:
- Gemini 2.5 Flash:输入 ¥1.5,输出 ¥12,缓存读取 ¥0.15
- Gemini 3.1 Pro:输入 ¥10,输出 ¥58,缓存读取 ¥1
- Gemini 3.8 Flash:输入 ¥8,输出 ¥36,缓存读取 ¥0.8
- Gemini 4 Argon:输入 ¥10,输出 ¥48,缓存读取 ¥0.5
新注册账户会有 ¥1 的赠送额度,正好够你把配置和调用流程从头走一遍。充值档位是 ¥10、¥50、¥100、¥200、¥500、¥1000,支持微信支付和银行卡,也可以开具发票。余额用完再充即可,既没有月费压力,也不存在过期清零的问题。
估算成本时,可以把输入和输出分开看:输入用量大、输出较短的场景,单位输入价格较低的档位更合适;59API 的定价表为每个模型都标明了输入、输出和缓存读取三档价格,按你实际的调用组合来算,会更贴近最终账单,而不是只盯着一个单价。
要不要顺便买一张月卡或周卡?
有些开发者会问:既然按量付费,为什么还有月卡和周卡?59API 的卡是可选的,不是必买项。卡有自己独立的 key,只能调用对应系列的模型,并且只从卡里扣费:卡不会回落到钱包余额,余额 key 也不会去消耗卡里的额度,两套体系互不干扰。卡内未用完的额度不会结转到下一周期。
需要留意的是,Gemini 不在月卡和周卡的覆盖范围内,现有卡针对的是 Claude 和 GPT 系列,所以 Gemini CLI 的调用走的就是预付余额。也就是说,Gemini 用户完全可以只走余额这一条路径,简单直接,也不用研究卡片的计量规则。
如果你确实要开卡,可以先看两个例子。【周卡】G-PRO $1500(GPT,7 天)售价 ¥292,额度 $1500,周上限 $1500;【周卡】C-PRO $600(Claude,7 天)售价 ¥289,额度 $600,周上限 $600。卡里的额度和上限是卡片计量单位,写成 $,并不等同于官方标价美元,所以不要把它直接换算成官方价格来做比较。
换到别的客户端还能不能用?
最后一个高频问题是:换到别的客户端还能不能调用?Codex、OpenAI SDK、cURL 以及 Cursor、Cherry Studio、Cline、OpenCode 这些 OpenAI 兼容客户端走的是另一条路:base_url 填 https://api.59api.com/v1,聊天接口是 https://api.59api.com/v1/chat/completions,它们对应 GPT、DeepSeek 以及其他非 Claude、非 Gemini 的模型。Claude 不在这条路上,Gemini 也不在这条路上。
那么怎么选?看你手上的客户端:已经在用 Gemini CLI,就按第二节配好两个环境变量,然后用 ¥1 赠送额度跑一次真实请求;已经在用 Codex 或某个 OpenAI 兼容工具,就改 base_url 和接口地址,先用余额把链路验证通,再按模型价格和调用量决定要不要充值。
59API 把这些细节写清楚,目的就是让第一次接入少一点猜测:地址统一、计费透明、余额不过期。你可以先完成配置、跑通一次调用,再决定后续的充值节奏,把第一次使用变成一次顺手的小事。