---
title: "Аккаунт и баланс"
method: GET
path: "/v1/account"
tags: ["Account"]
---

# Аккаунт и баланс

`GET /v1/account`

## Request

- Base URL: `https://api.clipia.ai`
- URL: `https://api.clipia.ai/v1/account`
- Auth: API key in header `Authorization`

Возвращает баланс в кредитах и использование за 30 дней.
Стоимость 1 кредита в деньгах через API не раскрывается.
Доступно любому валидному ключу (scope не требуется).

## Response `200`

Сведения об аккаунте.

- Account
  - `account_id` string: Идентификатор аккаунта.
  - `balance` object, required
    - `credits` number, required: Текущий баланс в кредитах.
  - `usage_30d` object, required: Использование за последние 30 дней.
    - `requests` integer, required: Count of API/MCP calls, including polling; not generation count.
    - `credits_spent` number, required: Net settled ledger debits minus refunds for API operations started in the last 30 days; excludes reservations and duplicate calls.

## Other responses

- `401`: Ключ отсутствует, неверный или отозван.
- `429`: Превышен лимит. `error.type` всегда `rate_limit_error`; различайте по `error.code`: - `rate_limit_exceeded` — запросов в минуту (RPM) или токенов в минуту (TPM) по ключу; - `concurrency_limit_exceeded` — слишком много генераций одновременно (по ключу или по аккаунту). Дождитесь завершения одной и повторите. В обоих случаях сервер отдаёт заголовок `Retry-After` и дублирует подсказку в `error.retry_after_seconds`.

---

[API](https://skmtc.dev/clipia/apis/clipia-api.md) · [All operations](https://skmtc.dev/clipia/apis/clipia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clipia/apis/clipia-api/revisions/cc55924a3381?raw)