计费指南
先理解三个概念
- 账户余额:你的总可用额度
- Key 限额:某个 API Key 自己的额度上限(可单独设置)
- 订阅限额:日/周/月窗口限制(如果你开了订阅或月卡)
这三层都会影响请求是否成功。
充值方式
充值入口:https://anideaai.com/console
系统会按当前配置展示可用渠道,常见包括:
- Stripe
- Creem
- 微信支付(迅虎)
- 易支付
可通过接口获取当前账号可见的充值配置:
GET /api/user/topup/info
提交充值订单(登录态):
POST /api/user/topupPOST /api/user/stripe/payPOST /api/user/creem/payPOST /api/user/xunhu/payPOST /api/user/pay(易支付)
余额查询
控制台查看
登录后可直接在控制台查看余额与累计消耗。
接口查看
GET /api/user/self- 返回字段重点:
quota(剩余额度)、used_quota(已用额度)
金额换算(美元)
GET /api/status可读到quota_per_unit- 当前快照
quota_per_unit = 500000 - 计算:
- 剩余美元 =
quota / 500000 - 已用美元 =
used_quota / 500000
- 剩余美元 =
用量统计与账单追踪
- 请求明细:
GET /api/log/self - 用户维度汇总:
GET /api/log/self/stat - 充值记录:
GET /api/user/topup/self - 订阅窗口使用情况:
GET /api/user/subscription/stats
建议做法:
- 每天拉一次
self/stat做成本看板。 - 对高成本模型单独拆分 Key,便于追踪。
- 异常升高时先看
log/self的模型分布和调用高峰。
配额与限额机制
1) 账户层
账户余额不足会触发额度错误,常见码:
QUOTA_USER_INSUFFICIENT(账户额度不足)
2) Key 层
每个 Key 可独立配置:
remain_quota:Key 剩余额度unlimited_quota:是否无限额expired_time:Key 过期时间
Key 额度不足时常见码:
QUOTA_TOKEN_INSUFFICIENT
3) 订阅窗口层
如已开订阅/月卡,还会检查日/周/月窗口:
- 日上限:
QUOTA_MONTHLY_DAILY_EXCEEDED - 周上限:
QUOTA_MONTHLY_WEEKLY_EXCEEDED - 月上限:
QUOTA_MONTHLY_EXCEEDED - 订阅过期:
QUOTA_SUBSCRIPTION_EXPIRED
出现“额度不足”时怎么排查
- 先查
GET /api/user/self,确认账户余额是否足够。 - 再查对应 Key 的
remain_quota和过期时间。 - 如有订阅,再查
GET /api/user/subscription/stats的窗口是否超限。 - 最后到
GET /api/log/self看失败请求的错误码,按上面三层定位。