BestRelay 与 Gemini CLI 接入教程
上午九点:你写下的模型名,就是回话的那个模型
这是一个示例:你在自己的书桌前坐下,终端已经打开,Gemini CLI 在手边,BestRelay 的地址与密钥也已备好。你在请求里写下 Gemini 3.1 Pro,回话的就是 Gemini 3.1 Pro。BestRelay 是一家独立的 API 中转服务,它把每次请求按你写下的模型名转发给对应的模型提供方,不会在暗中把请求换成更便宜的档位。这句话听上去平常,却是中转这件事里该被写清楚的一句。
BestRelay 的阵容是精心挑选的 20 个公开模型,每一个都用自己的名字单独列出,并标明输入、输出、缓存写入、缓存读取四项价格。你在面板上看到的名字,就是调用时可以写的名字;写 Gemini 2.5 Flash,就不会得到 Gemini 3.8 Flash 的回答。当某个提供方下线了某个模型 id,BestRelay 会把这条目撤下,而不是留着名字让请求落空。挑选因此有了边界,你不必在一长串编号里猜哪个是自己要的。
上午这段工作通常不长:一段整理,一段翻译,一段把零散笔记并成一段话。示例里的你不需要为这些请求准备长期方案。BestRelay 没有月费,没有订阅,也没有最低消费;充多少就用多少,用多少就扣多少。对一个偶尔需要更强模型、偶尔只需要轻量模型的人来说,这比事先猜一个月要写多少行代码省心。
Gemini CLI 走的是 Gemini 自己的原生协议
示例继续。你在 Gemini CLI 里配置 BestRelay,需要两样东西:一个是服务地址,另一个是在控制台 API keys 下新建的密钥。地址与各项设置写在 BestRelay 的文档里,这里不逐条抄出,也不需要抄出来。真正值得先弄清的,是 Gemini 家族走的是它们自己的原生协议,通过 Gemini CLI 或者直接的 generateContent 调用进入,而不是 OpenAI 兼容的接口形式。
这不是一个靠调整参数就能补上的缺口,而是协议本身不同。所以你不会在 Gemini CLI 里寻找 OpenAI 兼容开关,也不用把 Gemini 硬塞进只认那种接口的客户端。同一份原则也适用于别的家族:Claude 模型只提供给官方的 Claude Code 和 Claude Desktop,版本需为 2.1.285 或更新,不在 Cursor、Cherry Studio、Cline、OpenCode、任何 SDK 或 cURL 中工作。Codex 以及上述这些工具对应的,是 GPT、DeepSeek、Kimi、GLM、Qwen 和 Grok。配对之前先看一眼这一条,能省掉一整个下午的排查。
示例里的上午因此很安静:你只改模型名,不改工具,也不动协议。快到十点时,你把一次请求从 Gemini 3.1 Pro 换成 Gemini 2.5 Flash,回来的东西换了性格,价格也跟着换了,而设置一个字都没多写。
按量付费:请求结束之后,才从余额里扣钱
BestRelay 采用预付的按量付费余额。你先充值,余额留在账户里;每次调用结束后,按提供方报告的 token 数量和价目表价格扣一次费,不会提前扣住一笔钱等你慢慢消耗。账目是单次的,调用一次,结算一次。这对按天工作的人是合适的:你今天写多少,付多少。
如果请求被提供方拒绝,这条记录按 ¥0 记;如果提供方根本联系不上,什么都不会扣。这两条规则听上去寻常,在真实工作里却要紧——一次语法写错或一次网络中断,不该变成余额上的窟窿。新账户开通时带有 ¥2.20 的赠送额度。举例来说,这笔额度大约能覆盖 1.4 百万个 GPT-6.1 Sol 的输入 token,够你把工具装好、把参数试一遍,再问几个真正想问的问题。
充值通过 Stripe 结账完成,可选金额是 ¥10.00、¥50.00、¥100.00、¥200.00、¥500.00 和 ¥1,000.00。想先小步试水就选 ¥10.00,确定要长期使用再往上加。未使用的余额可以申请退款,条件是在充值后 13 天内,且会扣除已消耗的部分与支付机构的手续费;赠送额度与佣金不可退款。规则写在这里,是因为它本来就该被写在这里。
一天的账目,用两个示例看清楚
以下是示例,不是承诺,也不是别人的成绩单,只是把 BestRelay 的价目表摆开给你看。示例之一是 Claude Sonnet 5.5:一天用掉 500,000 输入 token 和 100,000 输出 token,在 BestRelay 上是 ¥10.05;这样的 22 天是 ¥221.10。如果当天有 350,000 的输入从缓存读取,这一天是 ¥6.79。按官方标价,同样的一天是 ¥14.40,22 天是 ¥316.80,缓存那天是 ¥9.61;一天的差额是 ¥4.35,22 天的差额是 ¥95.70。
另一个示例是 GPT-6.1 Sol:同样是 500,000 输入和 100,000 输出,在 BestRelay 上一天是 ¥1.55,22 天是 ¥34.10;其中 350,000 输入走缓存读取时,一天是 ¥1.13。按官方标价,同一天是 ¥14.40,22 天是 ¥316.80,缓存那天是 ¥9.61;差额分别是 ¥12.85 和 ¥282.70。两个示例的形状相同:价格表是公开的,token 是可数的,账是可以自己核对一遍的。
BestRelay 把输入、输出、缓存写入、缓存读取四项价格分别列出,你不必猜一次长对话里哪部分更贵。举例来说,缓存读取一栏的价格在表上低于同一条目的输入价格。至于该选哪一档,示例里的你上午用 Gemini 2.5 Flash 起草,下午用 Gemini 3.1 Pro 收尾;因为 BestRelay 按你写的名字转发,你不必为“更贵”或“更便宜”这两个词做任何含糊的妥协。
密钥、记录与边界:把该有的约束写明
BestRelay 的限制是明确的:一个密钥每分钟 120 个请求,一个账户同时在途 8 个调用。对一个人在自己的书桌前使用,这个额度足够宽裕;对一条失控的循环,也足够把它拦下来。一个账户可以持有多个密钥,任何一个都可以随时作废。每一次调用都会出现在用量记录里,带着它的模型名、token 数量和扣费金额。示例里的你月底想核对某一天的开销时,能直接翻到那一天,而不是靠回忆。
隐私方面,请求中由你写下的文字会保留 30 天,用于审查滥用和处理计费疑问;系统提示和模型回复不存储。你写的部分会被看见一段时间,模型说的话不会。还有一条是推荐关系:通过你的链接加入的人充值,你得到其充值的 18%;他们再邀请的人充值,你得到 4%。举例来说,被邀请成员充值 ¥100.00 时,两笔佣金分别是 ¥18.00 和 ¥4.00。佣金可以转入余额,也可以从 ¥150.00 起提现到支付宝。
示例的一天天就这样过去:早上写清模型名,中午翻一次用量记录,晚上对一次账。BestRelay 把可查的部分都留在明面上,你可以从 Gemini CLI 起步,慢慢把它变成日常工作里用得顺手的工具。