---
title: Аккаунт и баланс
description: GET /v1/account — доступный баланс аккаунта в кредитах, число запросов и списанные кредиты этого ключа за последние 30 дней.
icon: Wallet
---

Получите доступный баланс аккаунта в кредитах и статистику использования ключа.

## Песочница

<Callout type="info" title="Для проб — тестовый ключ">
В форму ниже вставляйте ключ `clipia_test_…`: он не списывает кредиты и не вызывает модели, а ответ приходит в том же формате. Форма запоминает ключ в этом браузере, поэтому боевой `clipia_live_…` — серверный секрет — в неё не вводите. Подробнее — [«Тестовый режим»](/ru/docs/getting-started/sandbox).
</Callout>

<ApiPlayground path="/v1/account" method="get" />

`GET /v1/account` возвращает баланс аккаунта, к которому привязан ключ, и сводку по этому ключу за последние 30 дней. Хватит любого действующего ключа — отдельное право не нужно.

<Method name="GET" path="/v1/account" />

## Запрос

<Tabs items={['cURL', 'TypeScript', 'Python']}>
<Tab value="cURL">

```bash
curl https://api.clipia.ai/v1/account \
  -H "Authorization: Bearer $CLIPIA_KEY"
```

</Tab>
<Tab value="TypeScript">

```ts
const account = await clipia.account.get();
console.log(account.balance.credits);
```

</Tab>
<Tab value="Python">

```python
account = client.account.get()
print(account["balance"]["credits"])
```

</Tab>
</Tabs>

**Ответ `200`**

```json
{
  "account_id": "8f3a1c7e-2b4d-4e6f-9a01-23456789abcd",
  "balance": { "credits": 1840 },
  "usage_30d": { "requests": 512, "credits_spent": 6120 }
}
```

<TypeTable
  type={{
    account_id: { type: 'string', description: 'Идентификатор аккаунта' },
    'balance.credits': { type: 'integer', description: 'Доступный баланс: кредиты подписки и купленные кредиты за вычетом зарезервированных под незавершённые задачи' },
    'usage_30d.requests': { type: 'integer', description: 'Сколько запросов к API сделал этот ключ за 30 дней, включая опрос статуса' },
    'usage_30d.credits_spent': { type: 'number', description: 'Сколько кредитов списано по этому ключу за 30 дней, с учётом возвратов. Тестовый ключ ничего не списывает: у него здесь 0, хотя requests считаются' }
  }}
/>

<Callout type="info" title="Кредиты">
Генерации и LLM-чат списывают кредиты с баланса аккаунта, к которому привязан ключ. Пополнить баланс можно в личном кабинете на clipia.ai. Если кредитов не хватает, отправка вернёт `402 insufficient_credits`, а если у аккаунта нет активной подписки — `402 subscription_required`; подробнее в разделе [«Ошибки»](/ru/docs/api-reference/errors). Баланс в этом ответе такой запрет не показывает.
</Callout>