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

# 计费与额度

> 了解计费方式、查询余额及查看交易历史。

ARouter 采用预付费额度系统。您向账户充值后，ARouter 会随着请求的完成从您的额度余额中扣除相应费用。

推理定价本身遵循上游提供商的模型定价。ARouter 对额度购买、退款、BYOK 使用和余额处理，均适用此处描述的相同计费规则和运营政策。

## 计费方式

当您发出请求时，ARouter 从提供商处接收最终用量数据，并根据您的额度余额计算相应扣费。

每次请求可能包含：

* **输入 Token**：您的提示词或消息中的 Token
* **输出 Token**：模型生成的 Token
* **缓存 Token**：在支持的情况下从提示词缓存中调取的 Token
* **推理、图像或音频 Token**：模型返回的其他用量类别

```json theme={null}
{
  "usage": {
    "prompt_tokens": 500,
    "completion_tokens": 200,
    "total_tokens": 700,
    "prompt_tokens_details": {
      "cached_tokens": 400,
      "cache_write_tokens": 100
    }
  }
}
```

在此示例中：

* 400 个 Token 以缓存 Token 费率从缓存中调取
* 100 个 Token 以标准输入费率写入缓存
* 200 个输出 Token 以输出 Token 费率计费

## 定价与费用

ARouter 直接传递提供商推理定价，不额外加价。购买额度时，将在额度金额之上收取平台费用。加密货币充值的费率可能与银行卡支付不同。

如果您使用自带密钥（BYOK），每月可享受免费额度，超出部分将收取少量 ARouter 平台费用，而提供商端的推理费用将通过您自己的密钥计收。

## 额度过期与退款

未使用的额度可能在购买后一年内按计费条款过期。

未使用额度的退款申请须在购买后 24 小时内提出，逾期后未使用额度将不予退款。平台费用不予退款，加密货币支付亦不可退款。

若购买后余额未立即更新，请等待支付提供商结算完成。如果扣款成功但额度仍未到账，请通过控制台联系客服并提供购买详情。

## 查询余额

使用余额接口查询您账户的当前额度余额：

```
GET /api/v1/balance
```

```bash theme={null}
curl https://api.arouter.ai/api/v1/balance \
  -H "Authorization: Bearer lr_live_xxxx"
```

响应：

```json theme={null}
{
  "balance": 42.50,
  "currency": "USD"
}
```

`balance` 字段表示您以 USD 计算的剩余额度。

## 交易历史

查询完整的交易历史：

```
GET /api/v1/transactions
```

```bash theme={null}
curl https://api.arouter.ai/api/v1/transactions \
  -H "Authorization: Bearer lr_live_xxxx"
```

响应：

```json theme={null}
{
  "transactions": [
    {
      "id": "txn_xxx",
      "type": "usage",
      "amount": -0.0042,
      "description": "openai/gpt-5.4 — 500 input tokens, 200 output tokens",
      "created_at": "2026-04-03T10:00:00Z"
    },
    {
      "id": "txn_yyy",
      "type": "credit",
      "amount": 50.00,
      "description": "Credit purchase",
      "created_at": "2026-04-01T09:00:00Z"
    }
  ]
}
```

## 监控用量

您也可以在[控制台](https://arouter.ai/billing)查看余额、额度活动及请求级别的消费：

* 实时额度余额
* 按请求的用量明细
* 按模型和提供商的历史消费记录

## 购买额度

额度可通过控制台 [https://arouter.ai/billing](https://arouter.ai/billing) 购买。

ARouter 还支持通过 x402 支付协议进行链上额度充值，适合原生加密货币工作流。详见 [x402 支付指南](/zh/guides/x402-payments) 了解配置说明。

## 支付方式

ARouter 支持在控制台通过银行卡购买额度，以及针对受支持支付流程的加密货币充值。可用方式可能随时间扩展。

## 免费用量与限制

如果您的账户包含免费额度或促销额度，这些请求仍计入账户级速率限制和套餐限制。免费用量最适合用于测试，而非生产流量。