Token Plan FAQ
WOX Token Plan、订阅额度、API Key 与请求限制说明
Token Plan FAQ
WOX Token Plan、订阅额度、API Key 与请求限制说明
Token Plan 为账户提供在有效期内使用的订阅额度。订阅额度、钱包余额、API Key 限制和请求频率限制是不同的机制，会分别生效。
可购买的套餐、价格、有效期、额度、重置周期、购买上限和支付方式以 Token Plan 页面 当前展示及结算页面确认为准。本文档不列出固定套餐或额度数值。
1. Token Plan 如何工作
购买成功后，系统会为账户创建一条有开始时间和结束时间的订阅记录。订阅生效期间，请求可以按照账户的计费偏好使用订阅额度。
Token Plan 与钱包余额可以同时存在。购买套餐不代表自动创建一种特殊 API Key，也不代表所有模型、请求频率或上游能力都会自动提升。套餐若包含分组或其他附加权益，以购买页面明确展示的内容为准。
2. 订阅额度如何扣除
每条订阅记录使用一个通用额度池。文本、图片、音频和异步任务不会默认拥有彼此独立的固定次数池。
一次请求的实际消耗可能受以下因素影响：
- 使用的模型和计费方式
- 输入、输出和缓存 Token
- 图片数量、质量、尺寸或其他生成参数
- 音频时长、任务时长及其他任务规格
- 工具调用和模型附加能力
- 渠道倍率、用户分组和上游价格
因此，订阅额度不能直接等同于固定的 Token 数、请求次数、图片张数或视频秒数。最终消耗以系统结算记录为准，具体模型价格以 模型与价格页面 当前展示为准。
3. 有效期与额度重置
不同套餐可以配置不同的有效期和重置方式。购买前请在套餐卡片和结算页面确认：
- 套餐有效期
- 额度是否重置以及重置周期
- 是否存在购买次数限制
- 订阅额度用尽后是否允许使用钱包余额
- 是否包含用户分组或其他附加权益
到达重置时间后，系统会按照套餐配置恢复该周期的可用额度。未使用额度通常不会累积到下一个周期；订阅到期后，剩余额度也不会自动转入钱包或其他订阅，除非购买页面另有明确说明。
4. 计费偏好
账户可以在钱包页面选择请求优先使用哪种额度来源。
| 计费偏好 | 行为 |
|---|---|
| 订阅优先 | 优先使用有效订阅；订阅不可用或额度不足时，是否回退到钱包取决于套餐配置 |
| 钱包优先 | 优先使用钱包余额；钱包不足时再尝试有效订阅 |
| 仅订阅 | 只使用有效订阅，不使用钱包余额补足 |
| 仅钱包 | 只使用钱包余额，不消耗订阅额度 |
当账户没有有效订阅时，保存的“订阅优先”设置不会创建订阅额度，系统会按照当前可用的计费来源处理请求。
5. API Key 与 Token Plan
WOX 用户创建的是通用 API Key，不需要为 Token Plan 单独创建密钥。订阅是否参与计费由账户的订阅状态和计费偏好决定。
每个 API Key 仍然可以单独配置：
- 密钥额度上限
- 有效期
- 可用模型
- 可用分组
- IP 访问限制
API Key 自身的限制会与账户订阅、钱包余额和平台请求限制同时生效。创建多个 API Key 不会增加账户的订阅额度、钱包余额或用户级请求上限。
API Key 用于访问控制、应用隔离和环境管理。请勿共享或公开密钥；因密钥泄露、自动化失控或第三方客户端配置错误产生的有效调用费用，原则上不予退还。
6. 请求频率限制
RPM（Requests Per Minute）表示每分钟允许处理的请求数。请求频率限制与订阅额度是两种不同机制：
- 请求频率限制控制单位时间内可发起或成功完成的请求数量
- 订阅额度控制请求结算后还剩多少可用额度
平台会按照当前系统配置对适用的 API 路由实施用户级请求限制。部分用户分组可能使用不同配置，上游服务商也可能实施额外的并发、频率或用量限制。
Token Plan 本身不默认承诺固定 RPM。实际限制以账户当前配置、接口响应和上游状态为准。达到限制时，接口通常返回 HTTP 429；响应包含 Retry-After 时应按其等待，否则应采用指数退避并限制重试次数。
7. 模型、图片与任务规格
WOX 聚合多个上游模型服务商。不同模型支持的接口、尺寸、宽高比、质量、时长和响应格式可能不同，也可能随上游调整。
因此：
- 不存在适用于所有图片模型的统一 1K、2K、3K 或 4K 输出尺寸表
- 精确尺寸是否被接受、拒绝或标准化，由具体模型和上游渠道决定
- 图片数量、音频时长和任务时长可能影响计费，但不代表套餐提供独立的固定生成次数池
- 模型可用性、价格和参数支持应以模型页面及对应接口返回为准
生产环境应针对所选模型验证参数、错误处理、超时和重试策略，不应依赖其他模型或其他上游的规格。
8. 购买、续费与退款
提交订单前，请确认结算页面展示的价格、支付方式、有效期以及是否自动续费。不同支付渠道可能提供一次性购买或周期性订阅，具体以结算页面和支付渠道订单为准。
取消自动续费只影响后续扣款，不等同于退还已支付订单。除适用法律另有规定或购买页面另有明确承诺外，Token Plan 不支持无理由退款。退款、异常扣费和服务无法继续提供等情况，按照 用户协议、订单规则及适用法律处理。
9. 常见问题
Q1：当前有哪些套餐和额度？
请查看 Token Plan 页面。套餐由系统动态配置，本文档不维护固定档位、价格或额度表。
Q2：购买后需要创建专用 API Key 吗？
不需要。现有或新建的通用 API Key 都可以按照账户的订阅状态和计费偏好发起请求，密钥自身的额度、模型、分组和 IP 限制仍然有效。
Q3：创建多个 API Key 会增加订阅额度或 RPM 吗？
不会。多个 API Key 可以用于应用和环境隔离，但不会叠加账户的订阅额度、钱包余额或用户级请求上限。
Q4：订阅额度用尽后会发生什么？
系统会根据计费偏好和套餐的余额回退配置决定是否继续使用钱包余额。选择“仅订阅”或套餐不允许回退时，请求会因可用订阅额度不足而失败。
Q5：图片、音频或任务如何扣费？
它们与文本请求一样按系统定价规则折算为通用额度。图片数量、质量、尺寸、音频时长和任务时长等参数可能影响消耗，最终以系统结算记录为准。
Q6：购买 Token Plan 会提高请求频率限制吗？
不一定。只有购买页面明确列出的分组或请求权益才属于套餐内容；平台和上游的其他限制仍会同时生效。
Q7：订阅额度会在重置或到期后累积吗？
通常不会。额度按照套餐配置在对应周期重置，订阅到期后停止使用。具体有效期和重置方式以购买时展示的信息为准。
10. 使用前确认
在购买或接入生产系统前，请确认：