> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openp.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 账户充值

> 人工充值流程、到账时效与发票申请

OpenPAI 采用 **预付费** 模式:账户额度耗尽后将无法调用付费模型,因此请在余额不足时及时充值。

## 充值方式

<Note>目前充值 **仅支持人工充值**,需联系您的专属代理人完成,控制台暂未开放自助支付。</Note>

当前所有充值均通过 **代理人** 手动完成:

<Steps>
  <Step title="联系代理人">
    联系您的专属代理人;如尚未对接代理人,可通过官网或官方社群联系客服获取联系方式。
  </Step>

  <Step title="告知金额并付款">
    告知需充值的金额,并按代理人指引完成付款。
  </Step>

  <Step title="代理人充值">
    代理人确认收款后,为您的账户手动充入对应额度。
  </Step>

  <Step title="额度到账">
    额度到账后,可在 **账户首页** 查看新的余额。
  </Step>
</Steps>

## 使用兑换码

如果你持有代理人下发或活动赠送的兑换码:

1. 进入 **充值** → **兑换码** 标签。
2. 输入 16-32 位的兑换码并点击 **兑换**。
3. 成功后额度立即到账,可在 **账户日志** 查询。

## 发票申请

如需开具发票,请联系您的代理人协助处理并提供发票抬头、税号等信息。

## 额度查询

* **账户首页**:实时余额、本月消耗。
* **账户日志**:每一笔充值、消耗、退款的明细。
* **令牌列表**:每个令牌单独的消耗统计。
* **API 接口**:[查询账户余额](/api-reference/account/balance)。

## 余额不足

当余额接近耗尽时,系统会通过以下方式提醒:

* **控制台 Banner**:登录后顶部展示警示。
* **邮件提醒**:可在 **个人设置 → 通知** 中开启。
* **API 响应头**:每个响应中包含 `X-OpenPAI-Remaining-Quota`。

余额为 0 时,所有付费模型调用将返回:

```json theme={null}
{
  "error": {
    "code": "insufficient_quota",
    "message": "账户额度已用尽,请充值后重试。",
    "type": "billing_error"
  }
}
```

## 常见问题

<AccordionGroup>
  <Accordion title="付款成功但额度未到账">
    请联系为你充值的代理人核查,并保留付款凭证 / 订单信息以备核对。
  </Accordion>

  <Accordion title="可以退款吗?">
    未消耗的额度可在 30 天内联系代理人申请退款,扣除已产生的手续费。已消耗或超过 30 天的额度无法退款。
  </Accordion>

  <Accordion title="充值是否有最低 / 最高限额?">
    充值金额与限额请与代理人确认。如需大额充值或企业付款,请联系商务通道。
  </Accordion>
</AccordionGroup>