OpenPAI 中存在 两级额度:账户额度 与 令牌额度。所有调用同时受两者约束。
账户额度
账户额度是整个账号的总余额,通过 充值 或 兑换码 增加,通过 API 调用 减少。
- 货币单位:人民币(¥)。
- 精度:小数点后 6 位(支持极小金额计费)。
- 过期:无过期时间。
令牌额度
每个令牌可独立配置最大可消耗额度。
| 配置 | 含义 |
|---|
-1 | 不限制,完全使用账户余额 |
100 | 该令牌累计最多消耗 ¥100,达到上限后请求返回 quota_exhausted |
用于团队 / 外部协作时,强烈建议设置具体额度上限,避免单密钥失控消耗整个账户余额。
双重判定
每次调用都会依次检查:
- 令牌是否启用、是否过期、是否在模型白名单内。
- 令牌剩余额度 ≥ 本次预估扣费(预扣)。
- 账户余额 ≥ 本次预估扣费。
- 调用成功后,按实际用量结算(多退少补)。
任一条件不满足都会立即返回错误,不会发起上游请求。
令牌过期
创建令牌时若设置了 过期时间:
- 过期当日 0 点起立即停用,使用该密钥的请求返回
401 invalid_api_key。
- 过期令牌不会自动删除,可在控制台 延长有效期 或 删除归档。
兑换码(Redemption Code)
兑换码是一种快速发放额度的凭证,支持:
- 单次兑换(一码一用)
- 多次兑换(N 人共享)
- 限时兑换(过期作废)
兑换时所获额度计入 账户余额,而非某把特定令牌。
未消耗的额度可申请退款,规则:
- 30 天内:支持原路退款,扣除支付渠道手续费。
- 超过 30 天:仅支持转入其他账号或留作未来使用,不再原路退款。
- 加密货币 / 兑换码:不支持现金退款,但可作废未消耗部分。
申请方式以控制台公告为准。
账户合并 / 转移
如需把 A 账号的余额转移到 B 账号:
- 双方账号均需通过邮箱验证。
- 通过工单提交转移申请,经人工审核(通常 1 个工作日)。
- 大额转移(>¥5000)请走商务通道。
监控与告警
- 余额阈值提醒:在 个人设置 → 通知 中设置低额阈值,触发后邮件提醒。
- 每日消耗摘要:可选订阅,每日发送昨日消耗汇总。
- 企业账号 Webhook:支持调用方自建告警系统接入。
