---
title: Аккаунт и баланс
description: "GET /v1/account — баланс и использование."
---

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

## Песочница

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

`GET /v1/account` возвращает баланс аккаунта в кредитах и сводку использования за последние 30 дней. Эндпоинт доступен любому валидному ключу — scope не требуется.

<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: 'number', description: 'Текущий баланс в кредитах' },
    'usage_30d.requests': { type: 'integer', description: 'Число запросов за последние 30 дней' },
    'usage_30d.credits_spent': { type: 'number', description: 'Списано кредитов за последние 30 дней' }
  }}
/>

<Callout type="info" title="Кредиты">
Генерации списывают кредиты с баланса аккаунта, к которому привязан ключ. Стоимость 1 кредита в деньгах через API не раскрывается — пополнить баланс можно в личном кабинете clipia.ai. При нехватке кредитов `submit` вернёт `402 insufficient_credits`.
</Callout>