Баланс и пополнение

С баланса личного кабинета оплачивается всё: и запросы к моделям, и дополнительные продукты вроде логирования. Отдельных счетов на разные сервисы нет. Расчёты в рублях, НДС включён в цену.

Списание по факту

Цены в каталоге указаны за миллион токенов. Это единица измерения, а не минимальная покупка и не пакет, который нужно выкупить целиком: списывается ровно за то, что израсходовано, пропорционально.

Разберём на примере. Пусть у модели цена 100 ₽ за миллион входных токенов и 500 ₽ за миллион выходных. В запросе ушли инструкция и вопрос, модель ответила абзацем текста. Сколько токенов на это потратилось, приходит в ответе, в объекте usage:

{
    "usage": {
        "prompt_tokens": 850,
        "completion_tokens": 120,
        "total_tokens": 970
    }
}

Стоимость считается по каждому виду токенов отдельно, а потом складывается:

• вход: 850 × 100 ₽ ÷ 1 000 000 = 0,085 ₽
• выход: 120 × 500 ₽ ÷ 1 000 000 = 0,06 ₽
• итого списано: 0,145 ₽

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

Токены — не единственная единица. У распознавания речи это секунды записи, у синтеза речи — символы во входном тексте, у поиска в интернете — число поисковых запросов. Принцип тот же: цена умножается на фактический объём.

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

Когда запрос не выполняется

Если на балансе недостаточно средств, запрос отклоняется с кодом 402 и сообщением Insufficient balance to run this request. — конечному сервису он не отправляется. Достаточность средств определяется по предварительной оценке, а не по цене готового ответа: как она считается, разобрано в статье про стоимость запроса.

Тот же код приходит, когда исчерпан бюджет ключа или аккаунта, — там своё сообщение. Разбор всех кодов — в статье про ошибки.

Пополнение

Банковской картой или через СБП — в разделе «Баланс» кабинета. Зачисление происходит сразу после оплаты.

Юридические лица оплачивают по счёту. После регистрации договора счёт можно сформировать в кабинете. Баланс пополняется после поступления оплаты, как правило в тот же день.

Автопополнение

Автопополнение списывает деньги с привязанного способа оплаты, когда баланс опускается ниже заданного порога, и доводит его до целевого значения. Порог и целевой баланс задаются вместе, целевой должен быть больше порога.

Например, порог 500 ₽ и целевой баланс 3000 ₽. Как только на балансе останется меньше 500 ₽ — скажем, 480 ₽, — спишется 2520 ₽, и баланс станет 3000 ₽.

Контроль расходов

Уведомление о низком балансе. Письмо приходит, когда баланс опускается ниже заданной суммы. Например, при пороге 1000 ₽ письмо придёт на остатке 990 ₽, а запросы продолжат выполняться — это предупреждение, а не ограничение.

Ежемесячный бюджет аккаунта. Ограничивает расходы за календарный месяц по всем ключам. Отдельно задаётся сумма, при достижении которой приходит предупреждение. Например, бюджет 50 000 ₽ и предупреждение на 40 000 ₽: на 40 000 ₽ придёт письмо, а на 50 000 ₽ запросы начнут отклоняться до начала следующего месяца.

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

Запрос баланса из кода

GET /proxyapi/balance возвращает текущий баланс.

curl "https://api.proxyapi.ru/proxyapi/balance" \
    -H "Authorization: Bearer <КЛЮЧ>"

Для ключа без бюджета возвращается баланс аккаунта:

{
    "balance": 1234.56
}

Для ключа с бюджетом — остаток бюджета этого ключа, а не баланс аккаунта:

{
    "balance": 37.66,
    "budget": {
        "limit": 50.0,
        "used": 12.34
    }
}

Что дальше

• Стоимость запроса — из чего складывается цена и что списывается при ошибке.
• Ключи API — бюджет ключа, доступные модели и разрешения.
• Ошибки — разбор кодов ответа, включая 402.