企业 API 指南

先选择查询范围与凭证

单个 Key 用量/限额：使用该推理 API Key 调用 GET /v1/key，读取 usage、limit_remaining、limit_reset。这是 Key 的消费预算，不是企业钱包或授信余额。
企业钱包与授信：使用仅含 tenant:billing:read 的 MANAGEMENT Key 调用 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 接口。

管理 Key 默认 scope 包含写权限。仅监控时应显式选择 tenant:billing:read，不要省略 scopes 后使用默认全集。凭证应由企业主登录控制台签发；不得向客户或文档提交明文 Key。

所有金额单位为 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 限额、账户消费保护或其他策略仍可能拒绝请求；即使钱包尚有余额，授信耗尽也会阻止后付费新请求，因此总可用不等同于保证可调用额度。

对 Enterprise 余额接口使用推理 Key：改用有 billing read scope 的 MANAGEMENT Key。
对 /v1/key 使用管理 Key：改用要监控的推理 Key。
把 /v1/keys 当作管理 Key 接口：该接口要求登录态 JWT；机器管理走 /enterprise/v1/sub-accounts/{subAccountId}/api-keys。
401：检查凭证类型、有效期、撤销状态和 IP 限制。API_KEY_SCOPE_DENIED：检查所需 scope；不要盲目扩大到全部权限。
企业写操作返回 APPROVAL_REQUIRED：等待控制台人工审批并查询 operation，不要反复创建同一操作。