Appearance
Token 使用
「Token」是你在 TopsDyne 平台上的调用凭据与额度载体。用大白话讲：Token 就是「你的钥匙 + 你的余额」。
个人 Token（API Key）
个人 Token 绑定到你的账号，使用你的额度：
- 创建：控制台 → API Keys → 新建，生成
sk-xxx密钥（仅显示一次） - 通道：创建时二选一，创建后不可更改
- 按量 Key（默认）：调用按实际用量从余额扣减
- 套餐专用 Key（
sk-plan-前缀）：有生效中的个人订阅时可创建，只消耗套餐额度，用尽不会落到余额
- 管理：可查看用量、设置额度上限、随时撤销重建
提示：同一个账号可以同时持有两种 Key，分别用于不同工具，互不干扰。
额度体系
TopsDyne 采用「套餐额度 + 余额」双轨计费：
| 方式 | 说明 |
|---|---|
| 套餐额度 | 订阅套餐后获得固定调用额度（按次数或按 Token 用量），周期内使用；用 sk-plan- 套餐专用 Key 消耗 |
| 余额 | 按需充值，普通 Key（按量）调用按实际用量从余额扣减 |
两轨独立消费、不自动切换：套餐专用 Key 用尽会返回 402（可续费/升级套餐），按量 Key 只走余额。具体套餐档位与费用以控制台实时展示为准。
用量查询
登录控制台即可查看：
- 调用次数：按日 / 月的调用明细
- Token 消耗量：各模型用量统计
- 费用明细：每笔调用的扣费记录
- 各模型占比：费用与用量按模型分布
防超额保护
平台内置多重保护，防止异常调用掏空额度：
- 预扣机制：调用前按预估预扣、完成后按实际结算，多退少补；失败调用不扣费
- 窗口限额：套餐通道 5 小时 / 7 天双窗口上限，触顶自动拦截（响应 402 + 重试时间）
- 熔断保护：余额低于阈值时自动暂停调用，充值后自动恢复
常见问题
Q: Key 泄露了怎么办？
A: 立即在控制台撤销该 Key 并新建。平台对密钥加密存储，泄露后只需更换即可。
Q: 额度用完了怎么办？
A: 套餐专用 Key 额度用尽返回 402，续费或升级套餐即可恢复；按量 Key 为余额扣减，余额不足时充值即可。两种 Key 独立消费、互不冲突。
Q: 为什么提示 402 余额不足？
A: 余额低于阈值或窗口限额触顶。充值或等待窗口重置即可。