文档目录
计费与定价
按 token 计费的算法和算例;缓存、分时、长上下文分档、按次计价,以及中断请求和余额不足时怎么算。
本站按实际用量计费,从账户余额中实时扣减。价格以 模型定价 页为准,单位是每百万 token。
按 token 计费
一次请求的费用由几部分相加得到,每一部分用各自的单价:
| 项目 | 含义 |
|---|---|
| 输入 | 你发给模型的内容(提示词、历史消息等)中,没有命中缓存的部分。 |
| 输出 | 模型生成的内容。通常比输入贵。 |
| 缓存读取 | 输入中命中了缓存的部分,单价远低于普通输入。 |
| 缓存写入 | 首次把内容写入缓存时产生的费用,部分模型会单独标价。 |
费用 = 各项 token 数 ÷ 1,000,000 × 对应单价 × 分组倍率。价格页展示的已经是乘过默认分组倍率后的价格,也就是新用户实际会被扣的数。
算一笔看看
假设某个模型价格页上写的是:输入 ¥10、输出 ¥50、缓存读取 ¥1(每百万 token)。一次请求共发送 10,000 个输入 token,其中 8,000 个命中了缓存,模型输出了 1,000 个 token:
| 项目 | token 数 | 算式 | 费用 |
|---|---|---|---|
| 输入(未命中缓存) | 2,000 | 2,000 ÷ 1,000,000 × 10 | ¥0.020 |
| 缓存读取 | 8,000 | 8,000 ÷ 1,000,000 × 1 | ¥0.008 |
| 输出 | 1,000 | 1,000 ÷ 1,000,000 × 50 | ¥0.050 |
| 合计 | ¥0.078 |
这里的数字只是演示算法,实际价格以价格页为准。每一笔的 token 数和扣费都能在 使用记录 里看到。
想按自己的模型和用量算一笔,可以打开 API 费用计算器。它读取当前公开目录价,输入总量包含缓存读写,不会再重复乘默认分组倍率。
缓存读取与缓存写入
很多模型支持“提示词缓存”:当你反复发送相同的前缀(例如长系统提示词、大段代码上下文)时,模型可以复用之前的计算结果。命中缓存的部分按“缓存读取”价计费,通常只有普通输入价的一小部分;第一次写入缓存可能有额外的“缓存写入”费用。多轮对话、Agent 类工具(如 Claude Code、Codex)因此往往能明显降低成本。命中情况可以在 使用记录 的请求详情里看到。
分时计价
部分模型分“高峰”和“非高峰”两档价格,按请求发生时的时间计费,时间以北京时间为准。价格页会标出每个模型的高峰时段,以及当前正处在哪一档。请求详情里的“计费档位”会记录这笔请求实际用的是哪一档。
长上下文分档
部分模型按输入长度分档:输入不超过价格页标出的阈值时按标准价;超过阈值,整单按更高的长上下文价计费。具体阈值和两档价格见价格页。
按次计价
少数模型按调用次数计价,价格页会显示“每次”的价格,不再区分 token。
自动切换线路时怎么扣费
同一个请求如果某条线路失败、系统自动切到备用线路,只会按最终成功的那一次扣费,不会重复扣。
中断请求与计费
通过 API 调用时,即使你在响应完成前断开连接(关闭程序、客户端超时、主动取消),已提交的请求仍会在服务端继续完成,并按实际完成的全部内容计费;使用记录里能看到这类请求完整的 token 数。如果你的程序经常在响应中途超时断开,请调大客户端的超时时间。
控制台“AI 对话”页里点“停止”会立即中止生成,不会继续产生后续输出。
余额不足时
余额用完后请求会返回 402。充值后马上恢复,不需要更换密钥。见 注册与充值。
选好模型,核对费用再接入
查看当前模型的价格与参数,用自己的输入、输出和缓存用量估算成本;遇到报错时按错误码排查。