余额与额度
RouteAPI 是预付费模式：先给账户充值，调用时按实际用量从余额中扣费。你可以给每个 API 密钥单独设置额度，也可以开启自动充值，避免余额耗尽导致服务中断。
账户余额、模型价格、API 密钥额度和充值金额都以美元（USD）计价。控制台可能按站点设置把金额换算成其他货币显示，这只是显示层面的换算，扣费和记账始终以美元为准。
账户余额是你所有 API 密钥共用的资金池，在钱包页面查看当前余额和历史用量。
- 每次请求都从账户余额中扣费，余额不会被扣成负数。
- 余额不足以支付一次请求的预估费用时，请求会被拒绝，返回
403，错误码为insufficient_user_quota。预估方式见用量与计费。 - 如果你的账户享有专属折扣，模型广场会展示折扣后的价格，使用日志会标注「专属倍率」，扣费按折扣后的价格计算。
API 密钥额度
Section titled “API 密钥额度”在 API 密钥页面创建或编辑密钥时，可以为每个密钥单独设置：
| 设置 | 说明 |
|---|---|
| 额度（美元） | 这个密钥最多能消费的金额，也可以设为无限额度 |
| 过期时间 | 到期后密钥失效，默认永不过期 |
| 模型限制 | 只允许这个密钥调用指定的模型 |
| IP 白名单 | 只接受来自指定 IP 的请求 |
密钥额度是一个上限，不是单独的钱包。一次请求会同时扣减密钥额度和账户余额，两者任一不足，请求都会被拒绝。即使设置了无限额度，实际可用金额也受账户余额限制。
常见用法是给不同项目、环境或成员分别创建密钥并设置各自的额度，防止单个应用失控耗光整个账户的余额。API 密钥列表会显示每个密钥的已用额度和总额度。
| 情况 | 返回 |
|---|---|
| 密钥额度已用完 | 401，提示密钥额度已耗尽 |
| 密钥剩余额度不足以支付本次预估费用 | 403，错误码 pre_consume_token_quota_failed |
| 密钥已过期或已禁用 | 401 |
| 请求了密钥不允许的模型，或来源 IP 不在白名单内 | 403 |
在钱包页面选择金额和支付方式完成充值，最低 1 美元。可用的支付方式以钱包页面展示为准。
- 余额按你填写的美元金额记入。
- 通过 Stripe 银行卡支付时，实际扣款包含充值金额 4% 的手续费，用于覆盖支付处理费和税费。付款前页面会展示实际扣款金额。
开启自动充值后，余额低于你设置的阈值时，系统会用已保存的银行卡自动充值一笔固定金额，适合需要长期稳定运行的生产环境。在钱包页面的「自动充值」中配置。
| 设置 | 说明 | 范围 |
|---|---|---|
| 触发阈值 | 余额低于这个金额时触发充值 | 不超过 1,000 美元，默认 20 美元 |
| 每次充值金额 | 每次自动充值的金额 | 10–5,000 美元，默认 100 美元 |
| 每月上限 | 一个自然月内自动充值的累计上限，0 表示不限 | 不超过 50,000 美元，且不低于每次充值金额 |
| 支付方式 | 用于扣款的银行卡 | 最多保存 3 张，按设定顺序使用 |
工作方式：
- 每次请求结算后检查余额，低于阈值就触发一次充值。两次自动充值之间至少间隔 10 分钟。
- 保存设置时如果余额已经低于阈值，会立即触发一次充值。
- 默认卡被明确拒绝（如卡已过期、被发卡行拒绝）时，会依次尝试下一张已保存的卡。结果不明确时（如需要 3D 验证）不会换卡，以免重复扣款。
- 所有卡都失败后，会在 15 分钟、1 小时、3 小时、6 小时后自动重试。仍然失败就停止重试，并发邮件通知你。钱包页面也会显示提示，更换支付方式后可以点击「立即充值」。
- 达到每月上限后，当月不再自动充值。
- 自动充值同样收取 4% 的手续费。
在个人设置的通知设置中可以设置余额提醒阈值，余额低于阈值时通过邮件、Webhook、Bark 或 Gotify 通知你。余额耗尽导致请求被拒绝时，系统也会发邮件提醒，每天最多一次。