usage 可用于观测 Token 消耗，实际费用以平台用量记录及账单为准。
查看消耗
进入控制台的用量页面，按界面提供的时间范围、密钥或模型筛选。公开说明包含趋势与请求明细视图，可用请求 ID 定位调用。展示字段与刷新时效以当前控制台为准。
请求明细可以按时间、来源、API Key 和请求 ID 筛选，并查看状态、耗时、Token 与费用。
理解 Token 与费用
Chat 响应通常包含 prompt_tokens、completion_tokens 和 total_tokens。部分模型提供缓存用量明细。不同模型可能采用不同输入、输出、缓存或媒体计费方式，不能把总 Token 简单乘以单一价格。模型价格、币种、充值方式、最低金额、退款规则及缓存优惠，均以当前模型详情、控制台和正式条款为准。价格以当前公布信息为准；积分返利及邀请奖励请见积分与邀请奖励。
分组定价与计费规则
什么是分组定价
APIONE 支持按分组设置模型价格。同一个模型在不同分组中可以采用不同的价格，满足个人开发者、企业客户及不同业务场景的需求。发起请求时，系统会根据该 API Key 选择的分组，自动应用对应的模型价格。分组如何影响价格
具体分组名称、可用模型及价格，以平台实际展示为准。一个分组不一定支持平台上的全部模型。
Token 费用如何计算
对于按 Token 计费的模型，当输入、输出单价均以“每百万 Token”为单位时，可按以下公式计算基础费用：计算示例
假设一次请求使用 10,000 个输入 Token 和 2,000 个输出 Token，输入、输出单价分别为每百万 Token 的 P 和 Q，则基础费用为0.01 × P + 0.002 × Q。这是公式演示，P、Q 需替换为所选模型和分组的实际单价。
如何选择分组
- 进入 APIONE 控制台，打开 API Key 管理页面。
- 创建或编辑 API Key，选择当前可用的计费分组。
- 核对该分组支持的模型，以及对应的输入、输出价格。
- 保存配置后，使用该 API Key 发起模型请求。
相同模型在不同分组下的价格可能不同。分组价格可能调整，请以平台最新展示为准；实际费用以平台用量记录及账单为准。
套餐额度与充值余额
APIONE 套餐为一次性购买，不自动续费。购买后一次性发放全部额度，不按天发放，有效期统一为 28 天。
按量计费余额独立于套餐，不受套餐升级和到期影响。套餐到期后自动失效，未使用的套餐额度清零；如需继续使用套餐，自行选择并重新购买。
有效期内升级
有效期内允许随时升级，按剩余时间比例补齐新旧套餐价格差额，立即生效。升级继承原套餐剩余有效期，不重新获得 28 天。例如，Plus 已使用 20 天，升级 Pro 后只剩 8 天。 保留旧套餐剩余额度，再按剩余时间比例增加新旧套餐的总额度差额，不重新发放一份完整的新套餐额度。多次升级均以升级前的当前套餐档位计算价差和额度差，避免重复领取。
示例按整天计算并显示到美分。实际结算按剩余时间比例计算，精度以升级确认页为准。
降级与到期
不支持降级；需等当前套餐到期后，自行选择并购买其他套餐。到期时仅清零未使用的套餐额度，不影响独立的按量计费余额，不会自动续费。充值后如何核对
- 在充值页选择金额，进入收银台，核对实际支付币种、金额及支付方式。
- 支付完成后返回 APIONE，检查订单状态和余额变化。
- 若订单仍在处理中，先查询原订单并保留支付凭证。
- 需要支持时，提供订单号、支付时间和金额，避免提交完整支付账号或 API Key。
控制并发
APIONE 按 API Key 控制同时执行的请求数，也可能遇到上游限流。并发配额以账户配置为准。批量任务应使用队列或信号量限制同时进行的请求。 429 响应包含Retry-After 时先遵守该值，再做有上限的指数退避与随机抖动；不要无限重试，也不要通过创建更多 Key 绕过服务限制。流式中断后不要静默重发，避免重复生成与费用。
失败、取消与中断如何计费
平台最终判定失败的模型调用不收费。客户端显示超时、主动取消、连接中断，或生成成功后下载失败，不等于平台调用失败；若平台已完成生成或确认了实际用量，相应费用按该模型和分组的规则结算。 流式请求应结合最终状态与实际用量判断，不能只看 HTTP 200、客户端错误提示或是否收到了全部输出。已生成的内容未被完整接收，也不代表没有发生调用。 状态或扣费有疑问时，保留请求 ID、发生时间和时区、模型、最终状态及错误信息，联系支持核查。核实误扣或重复扣费后更正账目；不要在状态未知时连续重新创建任务。成本检查单
- 控制历史长度与最大输出，避免无意义的长上下文。
- 先用小规模业务样例比较质量与实际消耗。
- 将测试与生产密钥分开，及时调查异常用量。
- 客户端报错时先核对平台最终状态，状态未知时避免立即重复请求。