# Wan API 餘額查詢介面 (https://wanapi.app/zh-tw/docs/balance)



此介面適用於所有模型。請以 `Authorization: Bearer YOUR_API_KEY` 將金鑰傳送到 `https://api.wanapi.app`。它會回傳金鑰所屬帳戶的餘額，不會變更任何資料。

`GET /v1/balance` 會回傳金鑰所屬帳戶的可用餘額。此介面只讀取資料。

```bash
curl https://api.wanapi.app/v1/balance \
  -H "Authorization: Bearer $WAN_API_KEY"
```

```json
{
  "object": "balance",
  "currency": "USD",
  "balance": 12.5,
  "key_remaining": null
}
```

| 欄位              | 說明                                            |
| --------------- | --------------------------------------------- |
| `object`        | 固定為 `balance`。                                |
| `currency`      | 固定為 `USD`。                                    |
| `balance`       | 帳戶可用餘額（美元）。Playground 與該帳戶的所有 API 金鑰共用此餘額。    |
| `key_remaining` | 此金鑰剩餘的額度上限（美元）；金鑰沒有上限時為 `null`。金鑰的花費不能超過任一數值。 |

## 錯誤 [#errors]

| 狀態  | 代碼                    | 說明                       |
| --- | --------------------- | ------------------------ |
| 401 | —                     | 缺少 API 金鑰，或金鑰無效、已停用或已過期。 |
| 503 | `balance_unavailable` | 請稍後再試。                   |