> ## 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-Hant/guides/x402-payments) 了解設定說明。

## 支付方式

ARouter 支援在控制台透過銀行卡購買額度，以及針對受支援支付流程的加密貨幣儲值。可用方式可能隨時間擴展。

## 免費用量與限制

如果您的帳戶包含免費額度或促銷額度，這些請求仍計入帳戶級速率限制和方案限制。免費用量最適合用於測試，而非正式流量。
