Перейти к основному содержанию
GET
Баланс
Возвращает текущий баланс кошелька в виде объекта «валюта → сумма». Ответа-обёртки нет: ключи верхнего уровня — это сразу коды валют, а значения — десятичные строки.

Пример

Ответ

200 OK:
Если у вас нет записей в кошельке, вернётся пустой объект {} — это не ошибка. Отсутствие ключа означает нулевой остаток в этой валюте, а не сбой.

Суммы — это строки

Суммы приходят строкой, а не числом. Разбирайте их в десятичное число (Decimal, decimal.Decimal или BigDecimal), а не в float или double: двоичное представление таких значений даёт артефакты при сравнении и округлении, которые проявятся при сверке списаний.
Не сравнивайте суммы строками и не разбирайте их в число с плавающей точкой. Ключ валюты (RUB, USD) фиксирован — ориентируйтесь на него, а не на порядок ключей.

Какую валюту тратить

Расходы в API обычно списываются в рублях — это баланс, который и нужен. Остальные валюты в ответе возвращаются для полноты: они отражают остатки вашего кошелька, но не переводятся в рубли этим эндпоинтом.

Стоимость запроса

Сколько именно списал конкретный запрос к текстовой модели, видно в самом ответе: usage.cost.total_cost в рублях. Баланс до и после — уже ваше дело. Подробнее — на странице Запрос чату и в разделе Тарификация.

Ошибки

Ошибки баланса приходят в OpenAI-формате: {"error": {"message": "...", "type": "...", "param": null, "code": "..."}}. Подробности — на странице Ошибки.

Что дальше

Модели и цены

Каталог моделей с ценами за миллион токенов

Тарификация

Как считается стоимость запроса

Быстрый старт

Первый запрос за три шага

Ошибки

Полная таблица кодов

Авторизации

Authorization
string
header
обязательно

API-ключ в формате sk-.... Альтернативно — заголовок X-Api-Key: sk-... (совместимо с Anthropic SDK).

Ответ

Баланс по валютам.

{key}
string