Token101 文档计费与积分
Token101 API 中的积分（credits）、订阅、充值与计费端点如何工作。
积分如何工作
Token101 使用预付费积分（credits）模型。换算规则很简单：1 credit = $0.01 USD。在请求执行层，积分会在请求处理前先被临时冻结，并在实际用量确定后调整。如果最终费用低于冻结额度，未使用的部分会自动退还。
积分的有效期取决于发放方式：订阅与周期发放的积分在周期结束时过期且不结转，购买的充值积分 默认不过期。注册礼在发放后 30 天过期。
订阅套餐
Token101 提供四个订阅等级，按月计费，可在定价页查看完整对比：
| 套餐 | 月价格 | 月度积分 | 模型范围 | 周消费上限 |
|---|---|---|---|---|
| Free | $0 | —（一次性注册礼 50） | 全部活跃模型 | 100 |
| Pro | $8 | 800 | 全部活跃模型 | 240 |
| Max | $18 | 1,800 | 全部活跃模型 | 675 |
| Ultra | $28 | 2,800 | 全部活跃模型 | 1,400 |
所有套餐（包括 Free）均可使用全部活跃模型，包括 Claude、GPT-5.x 和 Qwen。消耗由各套餐的消费上限约束。
Free 套餐详情
- 注册礼：邮箱验证后一次性赠送 50 积分（Free 套餐不再有每月循环赠送）
- 注册礼有效期：注册礼自发放起 30 天后过期，建议尽早领取并开始使用；具体积分数与有效期以当前活动设置为准，可能不定期调整
- 模型范围：全部活跃模型——注册礼积分可用于任意模型，Free 档消费上限负责控制用量
消费上限（Spend Cap）
每个套餐设有周、月消费上限，限制窗口内可消耗的积分总量（不受账户余额影响）：
| 套餐 | 周上限 | 月上限 |
|---|---|---|
| Free | 100 | 100 |
| Pro | 240 | 960 |
| Max | 675 | 2,700 |
| Ultra | 1,400 | 5,600 |
达到上限后，API 请求将返回限流错误，直到上限窗口重置（锚定计费周期）。
HotPricing 套餐
对于需要更大用量的用户，HotPricing 提供大额一次性充值包和周重置订阅，拥有更多积分与更高消费上限。
HotPricing PAYG（一次性充值）
| 套餐 | 价格（CNY） | 积分 | 周消费上限 | 月消费上限 |
|---|---|---|---|---|
| PAYGO 66 | ¥66 | 917 | 917 | 917 |
| PAYGO 199 | ¥199 | 2,764 | 2,764 | 2,764 |
| PAYGO 399 | ¥399 | 5,540 | 5,540 | 5,540 |
HotPricing PAYG 积分一次性到账，默认不过期——积分在用完前一直可用。每个套餐还会解锁更高的消费上限，允许每个窗口发起更多 API 调用。
HotPricing PAYG 套餐以人民币展示、按固定参考汇率（当前 ¥7.2 = $1，定期复核）折算为美元结算。每个套餐的 USD 结算价固定，非实时市场汇率换算。
HotPricing 订阅（周重置）
| 套餐 | 月价格（CNY） | 每周积分 | 过期规则 |
|---|---|---|---|
| HotPricing 199 | ¥199 | 691 | 7 天后过期 |
| HotPricing 399 | ¥399 | 1,385 | 7 天后过期 |
HotPricing 订阅以周重置方式发放积分——每周获得新的积分，未使用的积分在 7 天后过期。这种模式适合持续大量使用的场景，每周预算比滚动余额更重要。
VIP 等级
累计消费达到门槛后自动解锁 VIP 服务等级，享受优先支持：
| 等级 | 累计消费门槛 | 专属权益 |
|---|---|---|
| VIP1 | ¥299 | 优先活动通知、加速积分补充 |
| VIP2 | ¥1,299 | 稳定性监控、服务优先 |
| VIP3 | ¥2,999 | 运维优先、优先升级处理 |
| VIP5 | ¥5,999 | 专属客服、发布通知 |
| VIP8 | ¥9,999 | 战略支持、专属通道 |
VIP 当前为服务权益等级（计费折扣预留给后续阶段，暂不在结算时应用）。
标准 PAYG 充值
如果不需要 HotPricing 的大额套餐，标准 PAYG 充值以 USD 计价：
| 套餐 | 价格 | 积分 | 首充赠送 |
|---|---|---|---|
topup_5 | $5 | 500 | +50 |
topup_10 | $10 | 1,000 | +100 |
topup_20 | $20 | 2,000 | +200 |
topup_50 | $50 | 5,000 | +500 |
首次充值可获得 10% 赠送（赠送的积分有效期 30 天）。后续充值仅获得基础积分。
API 激活包
Free 用户需要先完成 API 激活才能创建 API Key。专用的 ¥4 激活包 会赠送 10 积分，足够开始使用 API。此套餐仅在 API Keys 设置页面提供，不在通用定价页展示。
模型定价
文本模型（按 Token 计费）
所有文本模型按 1M tokens 计费，输入和输出费率因模型而异。各模型的按 Token 价格展示在 支持的模型 页面，也可通过 GET /api/v1/public/models 获取——请从这些来源读取，而不要依赖一张静态价格表，因为价格会随模型目录演进而变化。
长上下文定价
部分模型在请求超过某个较大 Token 阈值（例如 200,000 tokens）后会切换到更高的定价档位。在当前可用的模型中，没有任何模型对长上下文收取更高费率——大上下文模型无论提示词长短都采用统一的按 Token 定价。请始终在 支持的模型 页面确认当前费率。
Reasoning Token 折扣
产生推理/思考 token 的模型（通常为 Codex 系列和高级 OpenAI 模型）可享受自动折扣：
| 模型系列 | Reasoning 折扣 |
|---|---|
| Codex 系列（gpt-5.3-codex、gpt-5.2-codex、gpt-5.1-codex） | 50% 折扣 |
| 非 Codex 的 OpenAI（gpt-5.1、gpt-5.2、gpt-5） | 25% 折扣 |
| Claude、Gemini、Qwen | 无折扣 |
即 reasoning tokens 按降低后的输出费率计费。例如，gpt-5.3-codex 的输出费率为 $10/1M，reasoning tokens 只需 $5/1M。
提示缓存计费
支持提示缓存的模型会自动复用重复的请求内容：
- 缓存命中（读取）：命中的部分只按输入价的 10–20% 计费（相当于节省 80–90%）。
- 缓存写入：首次写入缓存的内容按输入价的 1.25 倍计费（即加价 25%）。这就是为什么账单里可能出现单价略高于标准输入价的行——它对应一次缓存写入，之后的命中会把这部分成本省回来。
- 适用范围：只有支持提示缓存的模型（如 Claude 与 GPT 5.x 系列）才有以上价格调整；不支持缓存的模型按标准输入价计费，没有任何缓存加价或折扣。
- 节省金额：缓存为你节省的金额可在 用量页 查看。
使用边界：使用 Anthropic 协议的 cache_control 字段时，省略 ttl 即使用默认的 5 分钟缓存；显式设置 ttl: "1h" 会被拒绝（HTTP 400），请不要带该字段。
图片生成（按图计费）
图片生成使用按图计价模式，而非按 token 计费。价格随质量（quality）与尺寸（size）分层：
| 模型 | 质量档 | 每张图片价格 |
|---|---|---|
GPT Image 1 (gpt-image-1) | low | $0.011–$0.016 |
| medium | $0.042–$0.063 | |
| high | $0.167–$0.25 | |
| 未指定 | $0.25 |
在同一质量档内，非正方形尺寸略高于 1024×1024。请以 公开模型接口 返回的实时价格为准；参数说明详见 图片生成 页面。
查看使用情况
查看套餐、余额与配额状态的入口是 Dashboard > Usage。下方 /api/v1/me/* 端点为 Dashboard 提供数据，只接受浏览器登录会话，无法用 API Key 调用。如需程序化发现模型，请使用 GET /api/v1/models 并带上你的 API Key。用量与余额目前仅在 Dashboard 中查看。
计费 API 端点
| Method | Endpoint | Auth | Description |
|---|---|---|---|
GET | /api/v1/me/credits/balance | 登录会话（浏览器） | 当前积分余额和即将过期的积分 |
GET | /api/v1/me/billing/overview | 登录会话（浏览器） | 当前套餐、计费状态和可用模型 |
GET | /api/v1/me/subscription/quotas | 登录会话（浏览器） | 当前用量限制和消费上限 |
GET | /api/v1/me/topup/packages | 登录会话（浏览器） | 可用充值包和首充奖励资格 |
GET | /api/v1/public/models | 无需认证 | 所有模型及其定价 |
POST | /api/v1/payg/topup | 登录会话（浏览器） | 创建充值 checkout session |