Справка

Лимиты и оплата

Баланс аккаунта, лимит ключа и usage в ответе.

Списывается то, что модель реально посчитала. Оценка токенов в интерфейсе — ориентир; точная цифра — в usage ответа и в кабинете.

Где смотреть цены

В GET /models у каждой модели есть pricing.prompt и pricing.completion — за миллион входных и выходных токенов. Изображения тарифицируются отдельно, если для модели задан такой тариф.

История списаний — в кабинете: кошелёк и список запросов.

Usage в ответе

text

{
  "usage": {
    "prompt_tokens": 128,
    "completion_tokens": 40,
    "total_tokens": 168
  }
}

В streaming итоговый usage обычно приходит в последнем чанке. Не складывайте промежуточные значения как оплату.

В этот объект не входят изображения: за генерацию списывается тариф запроса (размер, качество, n). Сумму видно в кабинете.

Лимит ключа

У ключа можно включить лимит в долларах. Период сброса — день, неделя, две недели или календарный месяц. Граница всегда полночь UTC, не ваш часовой пояс. Кончился лимит — 403 с insufficient_quota, даже если на аккаунте ещё есть средства.

Без лимита ключ тратит общий баланс. Когда средств нет — 403 insufficient_balance.

Пополнение и история — в кабинете.

Слишком много запросов

Если запросов или токенов слишком много за короткое время, API вернёт 429 с rate_limit_exceeded. Это не про оплату. Подождите и повторите с увеличивающейся паузой. Пороги могут отличаться по модели.