TokenMP
工具接入

计费计划如何选择

TokenMP 提供多种计费计划，分别适合不同使用场景。

Coding Plan 按「5 小时滑动窗口」内的请求数计费，适合每天高频使用 AI 编程的开发者。比如你订阅了「Coding 基础版」，每个月可以在任意 5 小时窗口内发起 600 次请求。

Token Plan 按实际消耗的 token 数扣减，适合使用频率不固定、偶尔需要大量上下文的场景。每次请求的输入和输出 token 都会从余额中扣除。

Image Plan 用于图片生成请求，按图片计费额度扣减，不参与 LLM 文本请求的 Coding/Token 偏好切换。

5 小时滑动窗口是怎么算的

Coding Plan 的「5 小时窗口」不是固定的 5 小时（比如 0:00-5:00），而是一个滑动的统计窗口。

具体来说：每次你发起请求时，系统会看你过去 5 小时内已经用了多少次。如果没超过当前套餐的窗口配额，请求就会被允许；超过了就会返回 402。

举个例子：假设你的套餐是每 5 小时 600 次。你在 10:00 发了第 600 次请求，那在 15:00 之前（也就是最早那批请求退出 5 小时窗口之前），新请求会被拒绝。等到 15:00 之后，最早的一批请求退出窗口，你又可以继续发了。

这个机制的好处是：不需要等到月底重置，只要你控制好节奏，随时都可以用。

月度上限怎么算

除了 5 小时窗口限制，Coding Plan 还有月度总请求上限。每月 1 日 00:00（北京时间）重置。

Token Plan 没有窗口限制，只有 token 余额。余额用完就需要充值或兑换额度。

如果你同时拥有 Coding Plan 和 Token Plan，LLM 文本请求会按账户扣费偏好和 fallback_enabled 设置选择主计划与备用计划。

套餐升级与兑换续期

兑换 Coding Plan 套餐时，系统会先判断你当前套餐和新套餐的关系。如果新套餐等级更高，会为你升级；如果等级相同，会为你续期；如果新套餐等级更低，系统会拒绝兑换，避免把你当前更好的套餐误换成低等级套餐。

可以兑换的情况：当前没有 Coding Plan、当前套餐已到期、兑换同等级套餐用于续期，或兑换更高等级套餐用于升级，通常都可以继续兑换。兑换成功后，新套餐会立即成为当前套餐。

不能兑换的情况：如果你正在使用高等级套餐，却输入了低等级套餐兑换码，系统会提示兑换失败，错误码为 REDEEM_CODE_PLAN_DOWNGRADE。如果兑换码对应的套餐已经被停用，也会兑换失败，错误码为 REDEEM_CODE_PLAN_INACTIVE。

兑换后有效期怎么算：升级时，原套餐不会直接作废。系统会根据原套餐的剩余有效期和本月剩余额度，换算出一部分补偿天数，再加到新套餐后面。剩余时间越多、额度用得越少，补偿通常越多；如果快到期或额度快用完，补偿就会少一些。

常见情况：从基础版兑换到专业版，属于升级，新套餐会生效，并可能获得补偿天数；专业版继续兑换专业版，属于续期，有效期会继续往后延长；专业版兑换基础版，属于降级，系统会拒绝兑换。

兑换成功后在哪里查看：你可以在 Panel 的套餐页查看当前套餐和最终到期时间，也可以在账单流水中查看升级、续期或替换记录。如果兑换失败，请先确认兑换码是否有效、套餐是否仍在售，以及兑换码等级是否低于当前套餐。

  • 升级：兑换更高等级套餐，新套餐生效，旧套餐剩余价值会折成补偿天数。
  • 续期：兑换同等级套餐，当前套餐有效期继续往后延长。
  • 拒绝降级：低等级兑换码不能覆盖当前高等级套餐。
  • 最终到期时间：新套餐默认有效期 + 原套餐折算出的补偿天数。

扣费优先级与切换

当你发起 LLM 文本请求时，系统不是固定「先 Coding Plan 再 Token Plan」，而是按账户设置决定主计划和备用计划：

  • preferred_billing=coding 时优先尝试 Coding Plan；preferred_billing=token 时优先尝试 Token Plan。
  • 只有 fallback_enabled=true 时，主计划额度不足、未订阅或不可用才会尝试另一个 LLM 计费计划。
  • fallback_enabled=false 时不会自动切换；主计划不可用会直接返回 402。
  • 主计划和允许的备用计划都不够时返回 402 错误，你可以在 Panel 查看余额、配额和账单流水。

你可以在 Panel 设置中调整优先使用 Coding 还是 Token，也可以开启或关闭「额度不足时自动切换」。

免费模型与图片计费

部分模型和图片生成请求有独立规则，不走上面的 LLM 文本扣费偏好：

  • 路由 billing_mode=free_global 的免费模型请求不扣 Coding、Token 或 Image 额度；请求日志/流水中可能显示 billing_plan=free 或 billing_source=free_model。
  • 图片生成接口（/v1/images/generations）使用 Image Plan，账单和请求日志可用 billing_plan=image 过滤。
  • Image Plan 额度不足时按图片计费规则处理，不会因为 preferred_billing 或 fallback_enabled 切到 Coding/Token。

遇到 402 怎么办

402 表示余额或配额不足。常见原因和处理方式：

  • Coding Plan 窗口用完：等 5 小时窗口滑过，或者切换到 Token Plan。
  • Coding Plan 月度用完：等下月 1 日重置，或者升级到更高档套餐。
  • Token Plan 余额为零：在 Panel 充值或兑换兑换码。
  • Image Plan 额度不足：补充图片额度或选择可用的图片套餐。
  • LLM 文本请求只有主计划不可用且未开启 fallback_enabled：开启自动切换，或把 preferred_billing 改为当前可用计划。

查看公开套餐

公开套餐列表接口：

← BOT 接入