充值与账单
管理账号钱包余额、为子工作区设消费限额，以及查看月度帐单。金额单位为 USD（Credits）。概念见 钱包 · 配额 · 计费。
| 我想… | 去这里 |
|---|---|
| 打开控制台 | 控制台 · 额度 ↗ |
| 充值 | 充值（须在顶级工作区） |
| 给子区设消费上限 | 子工作区消费限额 |
| 看月度汇总 / 下 PDF | 月度帐单 |
| 看逐笔用量 | 用量 |
| 理解钱包 vs 配额 | 钱包 · 配额 |
充值只在顶级
侧栏 额度 在各工作区都有；充值按钮与侧栏 帐单 仅在 顶级工作区。子区提示「充值请切换到主账号顶级工作区」。
控制台入口
| 页面 | 路径 | 侧栏文案 | 可见范围 |
|---|---|---|---|
| 额度 | /account/workspace/{工作区标识}/balance | 额度 | 所有工作区（内容因顶级 / 子区而异） |
| 月度帐单 | /account/workspace/{工作区标识}/billing | 帐单 | 仅顶级工作区 |
额度页 · 顶级工作区
切换到顶级后打开 额度，通常可见：
- 可用额度（USD）；赠送与充值的拆分以控制台当前展示为准
- 充值按钮
- 子工作区消费限额池：各子区限额 / 已用 / 剩余 / 使用率；可设置、追加、收回
- 额度流水：充值 / 赠送等入账记录（类型、时间、金额）
- 余额过低、耗尽、赠送即将过期等告警
子工作区没有独立钱包：消费扣的是账号（所有者）钱包；子区限额只是消费上限，不预扣、不冻结余额。
额度页 · 子工作区
子区 额度 页侧重本区配额，一般包括：
- 本区消费上限、已用、剩余与进度
- 本周期 / 下次重置时间
- member 视角下：工作区配额、以及分配给自己的 API Key 配额进度（若有）
- 配额告警、耗尽、限额低于已用量导致 Key 不可用等提示
不能直接充值 → 切回顶级操作。
充值
- 切到 顶级工作区 → 额度 → 充值。
- 输入金额（USD）。当前自助渠道以控制台为准：弹窗流程为跳转 PayPal，单笔最低 $10。
- 在支付页完成付款后返回额度页，余额自动刷新。
政策（与控制台说明一致）
- 充多少到账多少 Credits；不另收充值平台费（若适用，销售税 / VAT 可能由支付渠道另计）
- Credits 购买后长期有效（政策调整会提前通知）
- 购买后 24 小时内，若该笔 Credits 尚未使用，可邮件申请全额退款；超时或已使用不退；不支持提现
- 部分地区可能限制充值（控制台会提示区域不可用）
流水里可能出现 Stripe、支付宝、微信、后台代充 / 赠送等类型，以实际开通渠道与入账记录为准。
账单、退款或技术支持：见额度页底部支持邮箱与 退款政策 相关入口（以站点当前链接为准）。
子工作区消费限额
仅在顶级 额度 页，由账号 owner 操作：
| 操作 | 说明 |
|---|---|
| 设置限额 | 为本周期设消费上限（整数 USD，常见范围约 2～1,000,000） |
| 追加配额 | 在当前上限上增加可消费额度 |
| 收回 | 取消该子区消费限额 |
要点：
- 未设限额 ≈ 不额外封顶，仍受钱包余额约束
- 设限额后，子区可用 ≈ min(剩余限额, 钱包余额)
- 限额调到已用金额以下需二次确认；可能导致该区 API Key 暂不可用（
over_limit） - 配额用尽时 API 常返回
403+workspace_quota_exceeded
子区可在 工作区设置 配置配额使用率告警（已分配限额时）。
余额与配额告警（常见）
| 场景 | 含义 |
|---|---|
| 账户余额不足约 $10 | 提醒尽快充值，避免调用中断 |
| 账户余额用尽 | 调用会被拒绝，需充值 |
| 赠送余额即将过期 | 尽快使用赠送部分 |
| 子区配额使用率偏高（如 ≥ 告警阈值） | 留意消耗或调高限额 |
| 子区配额用尽 / 限额低于已用量 | 回顶级充值、追加或调整限额 |
月度帐单
- 在顶级打开侧栏 帐单。
- 选择年份，查看各月：消费总额、充值总额等。
- 点某月看详情：工作区消费分布、模型消费占比、当月充值记录等。
- 下载 PDF（系统生成汇总，文件名形如
xinghan-bill-{月份}.pdf）。
非正式发票
PDF 不是税务发票。正式发票以支付渠道凭证及合同为准。
推荐做法
| 场景 | 建议 |
|---|---|
| 个人试用 | 顶级充值即可；可不设子区限额 |
| 多团队 | 每团队一子区 + 合理消费限额 + 配额告警 |
| 生产防飙账 | 子区限额 + 生产 Key 额度上限 双保险 |
| 财务对账 | 顶级看月度帐单 PDF；明细用 用量 导出 |
常见问题
余额够，为什么子区还是调不通？
多半是子区消费限额用尽或被调到已用以下。回顶级查看「子工作区消费限额」，追加或调高；也要排除 模型权限 与 Key 问题。
子区能自己充值吗？
不能。切到顶级充值；子区只消费所有者钱包，并可被限额卡住。
赠送余额过期后怎么办？
自动改走充值余额；两者都不足时调用失败。
降低限额会退回已消费金额吗？
不会。限额只约束后续可消费上限。