# Проверка баланса Wan API (https://wanapi.app/ru/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`       | Доступный баланс аккаунта в USD. Playground и все API-ключи аккаунта используют общий баланс.          |
| `key_remaining` | Остаток лимита ключа в USD или `null`, если лимита нет. Расход не может превышать ни баланс, ни лимит. |

## Ошибки [#ошибки]

| Статус | Код                   | Значение                                                      |
| ------ | --------------------- | ------------------------------------------------------------- |
| 401    | —                     | API-ключ отсутствует, недействителен, отключён или просрочен. |
| 503    | `balance_unavailable` | Повторите попытку позже.                                      |