计费与用量
先选择查询范围与凭证
- 单个 Key 用量/限额:使用该推理 API Key 调用
GET /v1/key,读取usage、limit_remaining、limit_reset。这是 Key 的消费预算,不是企业钱包或授信余额。 - 企业钱包与授信:使用仅含
tenant:billing:read的MANAGEMENTKey 调用GET /enterprise/v1/billing/balance。不要用推理 Key 或 PROVISIONING Key。 - 账户费用汇总/请求对账:现有
GET /v1/billing、GET /v1/billing/requests/{request_id}使用推理 Key 或登录态 JWT;管理 Key 不能调用这些/v1接口。费用明细与余额是不同指标。 - 旧账户余额接口:
GET /v1/billing/balance保留兼容,返回账户级资金,不代表调用 Key 的剩余预算;新企业余额监控优先使用 Enterprise 接口。
Token360 按所选模型公开的定价规则计量每个模型请求。可以从响应、控制台和计费 API 核对费用。
费用如何计算
计费单位取决于模型,常见类型包括:
- 输入和输出 Token;
- 单独计价时的推理或缓存 Token;
- 生成图片数;
- 音频字符数或秒数;
- 视频时长、分辨率或其他模型专用单位。
始终以在线模型详情页的价格区为准。供应商公开价格不自动等于 Token360 路由价格;同一个模型的不同 SKU 也可能使用不同计量方式。
预估与最终费用
Playground 预估值仅用于规划。最终费用在请求完成后,按实测用量和当时生效的定价规则计算。输出长度、生成时长和供应商上报用量等因素可能使最终费用不同于请求前预估。
异步任务首次进入终态后,计费仍可能需要短暂时间完成归集。需要精确结算时,请使用请求级对账。
请求级对账
保存推理返回的 request 或 generation ID,并查询:
1GET /v1/billing/requests/{request_id}响应会说明请求是否已计费,并在可用时返回记录的用量和费用组成。面向客户的任务应使用该接口核对,不要只根据 Token 数自行估算。
账户用量
使用 GET /v1/billing 查询某个时间范围的账户用量汇总。企业管理员可以按授权的成员或 API Key 展示标识筛选。控制台也提供 Dashboard、请求详情以及可用时的 CSV 导出。
比较每日 API 结果、API Key 重置周期和每日消费保护时,应使用 UTC 边界。
后付费资金口径
所有金额单位为 USD。POSTPAY 下优先使用钱包充值余额,不足部分占用企业授信;赠送 Credit/代金券不参与扣费,也不计入总可用。
credit_limit_usd:授信总额。current_exposure_usd:当前开放账期已使用的授信。credit_remaining_usd:max(credit_limit_usd - current_exposure_usd, 0)。credit_available:POSTPAY 时等于剩余授信;PREPAY 时为可用代金券余额,二者不可混淆。total_spendable:POSTPAY 为max(wallet_available, 0) + credit_remaining_usd;PREPAY 保持wallet_available + credit_available。
历史待付账单不从剩余授信再次扣除。余额是已记录账务数据的查询快照,不是实时资金预留。授信耗尽、Key 限额、账户消费保护或其他策略仍可能拒绝请求;即使钱包尚有余额,授信耗尽也会阻止后付费新请求,因此总可用不等同于保证可调用额度。
消费控制
Token360 提供多个相互独立的控制:
| API Key 消费上限 | 单个 Key | 达到适用上限后停止该 Key。可选每日、每周或每月重置。 |
| 每日消费保护 | 账户 | 当 UTC 当日消费达到上限时,停止新的计费请求。 |
| 信用额度 | 后付费账户 | 可用信用耗尽时停止新请求。 |
| 低余额或信用使用率提醒 | 账户 | 发送预警;提醒不会自动充值或提高额度。 |
最严格的有效控制优先。提高每日消费保护无法覆盖已耗尽的信用额度。
调查计费差异
- 记录 request ID 与 UTC 时间戳。
- 对比响应
usage和请求级计费数据。 - 确认公开模型名和模型页展示的定价规则。
- 检查请求是否重试或重复提交。
- Batch 任务同时检查汇总费用与单行输出。
- 向支持提供 ID 与金额,但绝不提供 API Key 密钥。