充值与配额
单位约定
平台内部所有计费用配额 (quota) 这个内部单位,对客户显示为 USD,充值/账单则通过汇率换算成 CNY。
| 换算 | 说明 |
|---|---|
| 500,000 quota = $1 | 内部固定 |
| ¥7.3 = $1 | 平台汇率,随法币波动调整(写作时口径) |
| ¥1 ≈ 68,493 quota | 由上两条推出 |
一次调用扣多少 quota 由 定价与倍率 决定,控制台的账单页会直接换算成 USD / CNY 显示,不需要你自己算。
支持的充值方式
| 通道 | 到账 | 起充 | 手续费 |
|---|---|---|---|
| 兑换码 (Redemption) | 即时 | 无 | 无 |
| 支付宝 / 微信支付 | 依赖平台是否配置 | ¥5 起 | 无(若开通) |
| 手动划拨 | 由管理员操作 | — | 无 |
TIP
新用户建议先花 ¥5-10 走通一遍链路,稳定跑通后再一次性充够月消耗。不要一次囤太多——需求不确定、平台策略也可能变化。
使用兑换码
如果你从渠道商 / 邀请人处拿到一串兑换码(格式类似 rd-xxxxxxxxxxxxxxxx):
- 控制台 → 兑换码 → 输入 → 兑换
- 立即到账,出现在「个人剩余额度」
一个兑换码只能用一次。用过就作废,不要泄露给别人重复用。
额度用完了会怎样
- 单次请求扣费时如果账户剩余 < 请求预估费用,请求直接返回
insufficient_user_quota(HTTP 402) - 客户端应捕获此错误并提示用户充值。生产系统里建议监控账户余额,快到底了自动加钱或告警。
- 已经跑到一半的流式请求,如果最后计费超支了,只会扣到扣完为止,不会中断已完成的部分。
令牌级额度 vs 账户级额度
两层都可以限:
- 账户级 — 你钱包里所有钱,共用给所有令牌
- 令牌级 — 每把 Key 单独设一个上限(比如给外包的 Key 只给 ¥10 上限,防止跑飞)
令牌级额度用完 → 那把 Key 报 token_quota_exhausted,其他 Key 不受影响。账户级用完 → 全账户所有 Key 都停。
账单与日志
- 账单 — 控制台 → 数据看板:每天 / 每模型 / 每令牌的总消耗
- 调用日志 — 控制台 → 日志:每条请求的 request_id、模型、tokens、扣费、上游 channel_id、耗时。可按令牌、模型、时间筛选。
退款
不主动退款。特殊情况(大额、平台重大故障导致的服务不可用等)联系管理员,会核对情况按剩余额度处理。兑换码兑换后不可退。