¥6.84 的 Gemini 3.8 Flash 接入教程

01 / 先把 Gemini 3.8 Flash 的单价抄到计算器里

价格先看，算清再接。CheapRelay 价格表里的 Gemini 3.8 Flash，模型 id 是 gemini-3.8-flash，单位为每 1,000,000 tokens：输入 ¥6.84，输出 ¥30.80，缓存读取 ¥0.68。三个数字都来自当前价格表，没有月租，也不存在需要提前购买的固定套餐。账户采用预付余额，用多少扣多少，余额不过期。

为什么第一步要盯住这三个数字？因为同一个模型，聊天、代码修改和长文档总结产生的 token 结构不同，账单也会不同。输入 token 是模型读到的内容，输出 token 是模型写回的内容，缓存读取则对应重复利用的上下文。示例：一次请求输入 100,000 tokens、输出 10,000 tokens，按价格表计算，输入费用为 6.84 × 0.1 = ¥0.684，输出费用为 30.80 × 0.01 = ¥0.308，合计 ¥0.992。示例中的这次调用实际产生约 ¥0.99。

• ■ 首先记下输入价：每百万 tokens ¥6.84。
• ■ 其次记下输出价：每百万 tokens ¥30.80。
• ■ 再记下缓存读取价：每百万 tokens ¥0.68。
• ■ 最后准备一个能算 token 账单的预算：示例先用 ¥1 跑通请求。

这笔示例账的意义很直接：接入是否值得，不由宣传语决定，而由你准备运行的 token 量决定。CheapRelay 把单价摆在价格表里，输入、输出、缓存读取分别列明，开发者可以先拿自己的典型任务试算，再决定充值多少。

02 / 注册、充值与第一笔余额怎么安排

新账户注册后有 ¥0.60 注册赠送额度，可用于任意模型，不限 Gemini 3.8 Flash。这个额度适合先验证链路，而不是拿来支撑长期高并发任务。示例：若全部用于 Gemini 3.8 Flash 输入，按 6.84 ÷ 0.60 约等于每 11.4 tokens 花费 ¥1 的速度估算，¥0.60 大致对应 87,700 个输入 tokens；若全部用于输出，30.80 ÷ 0.60 约等于每 51.3 tokens 花费 ¥1，¥0.60 大致对应 19,400 个输出 tokens。两者都是按当前价格表做的示例，实际账单取决于输入、输出和缓存读取的组合。

余额逻辑也不复杂：先充值到账户，再按真实 token 扣费，没有月租，剩余余额不会到期清零。示例：充值 ¥10，调用一次上节算出的 ¥0.992 请求后，余额约剩 ¥9.008；再多调用一次相同结构的请求，余额约剩 ¥8.016。这里不把赠送额度混进充值余额的计算，赠送部分单独看即可。

• ■ 注册账户：领取 ¥0.60 注册赠送额度。
• ■ 验证请求：用 ¥0.60 赠送额度先跑通一次调用。
• ■ 充值余额：按预计 token 用量准备，例如先充 ¥10。
• ■ 核对扣费：每百万输入 ¥6.84、输出 ¥30.80、缓存读取 ¥0.68。

对预算敏感的开发团队，CheapRelay 的价值在于支出跟着使用量走。你不用因为偶尔调用一次 Gemini 3.8 Flash，就承担固定月租；项目暂停时，账户里的余额仍保留，后续恢复工作再继续使用。

03 / 用 Gemini CLI 接入 CheapRelay 的操作清单

Gemini 系列要走原生协议，通过 Gemini CLI 使用，路径是 /v1beta，不能把它当作 OpenAI 兼容接口来配置。CheapRelay 的 API 基址为 https://api.cheapapirelay.com，模型填写 gemini-3.8-flash。接入时把这三件事对齐：客户端是 Gemini CLI，协议路径是 /v1beta，模型 id 是 gemini-3.8-flash。

建议先发一条短请求，再逐步放大上下文。示例：第一次只输入 1,000 tokens、输出 500 tokens，输入费用为 6.84 × 0.001 = ¥0.00684，输出费用为 30.80 × 0.0005 = ¥0.0154，合计约 ¥0.02224。这个示例用于确认鉴权、地址、模型名和返回结果都正常，成本不足 ¥0.03。随后再把真实代码片段放进去，观察实际 token 构成。

• ■ 首先安装并打开 Gemini CLI：本次验证预算按 ¥0.03 计算。
• ■ 其次填写 API 基址 https://api.cheapapirelay.com：地址项费用 ¥0。
• ■ 再设置原生协议路径 /v1beta：路径项费用 ¥0。
• ■ 然后填写模型 id gemini-3.8-flash：模型输入 ¥6.84、输出 ¥30.80、缓存读取 ¥0.68，均按每百万 tokens 计。
• ■ 最后发送短请求：示例输入 1,000、输出 500 tokens，约扣 ¥0.02224。

为什么不省掉验证步骤？因为输入和输出单价相差明显。示例中同样增加 1,000 个输入 tokens，费用增加 ¥0.00684；增加 1,000 个输出 tokens，费用增加 ¥0.0308。输出部分接近输入单价的 4.5 倍，所以先确认返回是否完整、是否需要重复生成，比一开始就塞入超长上下文更合算。

04 / 三款 Gemini 放在价格表里怎么选

只看 CheapRelay 价格表中的 Gemini 行，Gemini 3.8 Flash 输入 ¥6.84、输出 ¥30.80、缓存读取 ¥0.68；Gemini 2.5 Flash 输入 ¥1.28、输出 ¥10.24、缓存读取 ¥0.13；Gemini 3.1 Pro 输入 ¥8.06、输出 ¥46.75、缓存读取 ¥0.81。三者可以按自己的任务结构直接比较，不需要猜。

示例任务一：输入 100,000 tokens、输出 10,000 tokens。Gemini 3.8 Flash 的费用是 6.84 × 0.1 + 30.80 × 0.01 = ¥0.992；Gemini 2.5 Flash 是 1.28 × 0.1 + 10.24 × 0.01 = ¥0.2304；Gemini 3.1 Pro 是 8.06 × 0.1 + 46.75 × 0.01 = ¥1.2735。这个示例里，3.8 Flash 比 2.5 Flash 多 ¥0.7616，比 3.1 Pro 少 ¥0.2815。

示例任务二：输入 500,000 tokens、输出 50,000 tokens。Gemini 3.8 Flash 费用为 6.84 × 0.5 + 30.80 × 0.05 = ¥4.96；Gemini 2.5 Flash 为 1.28 × 0.5 + 10.24 × 0.05 = ¥1.152；Gemini 3.1 Pro 为 8.06 × 0.5 + 46.75 × 0.05 = ¥6.3675。示例任务三：只读取 1,000,000 个缓存 tokens，3.8 Flash 为 ¥0.68，2.5 Flash 为 ¥0.13，3.1 Pro 为 ¥0.81。

• ■ 先用 Gemini 2.5 Flash 试任务：输入 ¥1.28、输出 ¥10.24、缓存读取 ¥0.13。
• ■ 其次用 Gemini 3.8 Flash 对照：输入 ¥6.84、输出 ¥30.80、缓存读取 ¥0.68。
• ■ 再用 Gemini 3.1 Pro 对照：输入 ¥8.06、输出 ¥46.75、缓存读取 ¥0.81。
• ■ 最后按示例任务选模型：例如输入 100,000、输出 10,000 tokens，三者分别为 ¥0.2304、¥0.992、¥1.2735。

结论不用复杂：输出占比高时，输出单价直接决定账单；输入占比高时，输入与缓存读取更重要。CheapRelay 的价格表让这些差异都变成可以代入的乘法，而不是模糊的“差不多”。

05 / 限额、错误提示与退款边界要提前看懂

接入前还要记住三个运行边界。每个 key 每分钟最多 120 次调用，每个账户最多同时 8 次调用。示例：若你把并发开到 20，即使 key 的分钟额度没有碰到上限，账户并发也会先受 8 次限制；把并发设为 8，就与账户限制对齐，不需要靠重试去挤时间窗。

余额不足时，接口返回 HTTP 402，它表示余额已经等于或低于零。示例：余额为 ¥0 时再发请求，不会产生可用调用；这时应先充值，而不是反复重试。若当前余额为 ¥0.50，同时发起 8 个请求，每个请求都可能继续消耗余额，因此批量任务前仍要看剩余金额。价格仍按每百万输入 ¥6.84、输出 ¥30.80、缓存读取 ¥0.68 计算。

• ■ 首先设置并发：账户同时调用按 8 次安排。
• ■ 其次控制频率：每个 key 每分钟按 120 次以内安排。
• ■ 再检查余额：低于或等于 ¥0 时准备充值，HTTP 402 就是余额信号。
• ■ 最后保留充值凭证：充值后 12 天内可申请未使用余额退款。

退款规则也要看清楚：充值后 12 天内，未使用余额可以退款，但要扣除已经花掉的部分和支付手续费。示例：充值 ¥100，已消费 ¥12.40，退款金额还要再减对应支付手续费，而不是直接退回 ¥100。把这条规则和余额不过期放在一起看，决策会更简单：短期不确定用量，就少充一些；退款窗口内核对好消费明细，再处理未使用部分。

06 / 邀请奖励能抵消多少成本，算完就知道

CheapRelay 还有一套可计算的邀请奖励。你直接邀请的用户消费后，你获得其实际支付金额的 20%；第二级用户消费后，你获得 6%。奖励进入可提现余额，最低提现金额为 ¥20，通过支付宝提现。它不是消费返券，而是单独记在奖励余额里的金额。

示例：直接邀请的用户实际支付 ¥100，你得到 100 × 20% = ¥20，已经达到最低提现门槛；第二级用户实际支付 ¥50，你得到 50 × 6% = ¥3。两项合计 ¥23，可提现余额为 ¥23。若直接邀请用户支付 ¥80、第二级用户支付 ¥30，则奖励为 80 × 20% + 30 × 6% = ¥16 + ¥1.8 = ¥17.8，尚未达到 ¥20 门槛，可以继续累计。

• ■ 首先分享直接邀请：按对方实际支付额的 20% 累计奖励。
• ■ 其次关注第二级贡献：按第二级实际支付额的 6% 累计奖励。
• ■ 再核对奖励余额：示例支付 ¥100 与 ¥50，对应 ¥20 与 ¥3。
• ■ 最后按门槛提现：奖励余额达到 ¥20 后，通过支付宝提取。

回到最初那笔示例账：Gemini 3.8 Flash 输入 100,000 tokens、输出 10,000 tokens，一次约 ¥0.992。示例运行 100 次，费用约 ¥99.2；同期若通过直接邀请获得 ¥20 的奖励，净支出约 ¥79.2。这里不把奖励当作使用前提，它只是在你已有真实邀请关系时，多一条可核算的抵消路径。

把整条路径压缩成一句话：先用 ¥0.60 注册赠送额度跑通 Gemini CLI，按 /v1beta 和 gemini-3.8-flash 配置，再用价格表里的 ¥6.84、¥30.80、¥0.68 计算真实用量；需要更多余额时充值，不需要固定月租，余额保留；遇到 HTTP 402 就充值，奖励满 ¥20 再提现。CheapRelay 把价格、计费、限额和退款都摆在明面上，开发者拿计算器就能决定它是否适合自己的工作量。