Справочник API

Оплата и баланс

Оплата из кошелька за каждый вызов. Модели с оплатой за токены тарифицируются за 1M входных и выходных токенов; модели изображений, видео и задач — за запрос. За неудачные запросы средства возвращаются автоматически.

#Оплата за токены

Входные и выходные токены учитываются отдельно. Полная цена каждой модели указана в её карточке на /models; итоговый фактический расход по каждому завершённому запросу виден в журнале запросов.

usage.json

{
  "usage": {
    "prompt_tokens": 128,
    "completion_tokens": 402,
    "total_tokens": 530
  }
}

В начале запроса квота резервируется заранее (по максимальной оценке из max_tokens), а после завершения ответа пересчитывается по использованию, о котором сообщил провайдер, — вы всегда платите только за фактическое использование.

#Оплата за запрос

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

#Ценовые уровни

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

Цены по уровням

size, quality и duration определяют тарифицируемый уровень — точная цена каждого уровня указана в карточке модели, а за неудачные вызовы средства возвращаются автоматически.

#Возвраты

Предварительно списанная квота возвращается автоматически, если запрос завершился ошибкой или асинхронная задача так и не завершилась. Журнал запросов показывает итоговый фактический расход, поэтому неудачные вызовы не выглядят как отдельные списание и возврат.

Актуальные цены моделей Страница цен

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

#Кошелёк

Всё использование оплачивается из одного предоплаченного кошелька — постоплаты по счетам нет. Все ключи тратят общий баланс, если у ключа не задан собственный предел квоты.

#Пополнение

Пополняйте баланс в разделе Консоль → Кошелёк. Доступные способы оплаты (карта / другие провайдеры) и минимальная сумма пополнения показываются при оформлении; там же можно применить код активации — средства зачисляются сразу.

Баланс не сгорает. Если платёж прошёл, но баланс не изменился в течение нескольких минут, создайте обращение в поддержку с номером платежа.

Открыть кошелёк

#Когда баланс заканчивается

Если баланса не хватает на предварительный резерв для запроса, вызов сразу завершается с 402 insufficient_quota — ничего не списывается. Пополните баланс и повторите; уже идущие длинные потоки никогда не обрываются посреди ответа.

#Использование и журналы

#Панель использования

В разделе Консоль → Использование показаны графики токенов и расходов по моделям и дням с разбивкой по ключам — так быстрее всего понять, какой проект или модель увеличивает затраты.

Открыть использование

#Фактический расход

Консоль → Журнал запросов — основной источник данных о расходах на API для клиента. В каждой строке — время, модель, использованные токены или цена вызова, ID запроса и итоговая фактически списанная сумма.

Открыть использование

#ID запросов

В каждой строке журнала запросов есть идентификатор запроса и время. Обращаясь в поддержку по конкретному вызову, укажите данные этой строки (время, модель, ID запроса) — так поддержка найдёт точную попытку у провайдера.

Промпты не сохраняются

Шлюз хранит метаданные (модель, токены, стоимость, время, ID запроса), но не содержимое промптов, — если только вы явно не включили логирование запросов для отладки.

Проблема не решена?

Пришлите нам ID запроса или текст ошибки, и мы разберёмся.

НазадЛимиты и повторы ДалееСтарые API и совместимость