Перейти к содержимому

Биллинг

Базовая модель

Стоимость считается в рублях, балансе ключа. Поток:

  1. Ты делаешь POST /generate — мы оцениваем стоимость и резервируем (hold) её на балансе.
  2. Если баланса не хватает — 402 Payment Required, задача не создаётся.
  3. Если хватает — задача создаётся, баланс уменьшается, в очередь уходит сообщение.
  4. При failed — стоимость возвращается на ключ автоматически.
  5. При completed — стоимость списана окончательно.
balance: 1000₽
│
│ POST /generate (модель с фиксированной ставкой)
▼
balance: 950₽ [hold]
│
├──── task completes → balance остаётся 950₽
│
└──── task fails → balance возвращается к 1000₽

Виды биллинга

В зависимости от модели стоимость считается одним из следующих способов:

1. Фиксированная цена за генерацию

Большинство моделей (image, многие video). В прайс-листе для модели указана цена за один запрос — её и резервируем. Цена видна заранее в каталоге.

Пример: Nano Banana — фиксированная цена за изображение. Точную ставку всегда берём из текущего каталога, а не из статичного примера в документации.

2. Цена × длительность видео

Применяется к Kling-, Seedance-, Wan 3.0- и MiniMax H3-семействам. В каталоге цена дана за секунду, hold = цена × duration параметр запроса.

Пример: ставка 12 ₽/сек, запрашиваешь 10-секундный клип → hold 120 ₽.

Список моделей с per-second биллингом:

  • kling-v2.6, kling-v2.5-standard, kling-v2.5-pro, kling-v2.1-master
  • kling-o1, kling-o1-edit, kling-o3, kling-o3-pro, kling-v3, kling-v3-pro
  • kling-v2.6-motion-720p, kling-v2.6-motion-1080p
  • seedance-2.0, seedance-2.0-pro, seedance-2.0-mini, seedance-2.0-fast, seedance-2.5, seedance-2.0-eco, seedance-2.5-eco
  • wan-3.0, wan-3.0-prime, minimax-h3

С 27 октября 2026 года сниженные базовые тарифы Seedance доступны всем: Seedance 2.5 без видеовхода стоит 11,50 ₽/с в 480p и 26,10 ₽/с в 720p. С видеореференсом ставка составляет 7 ₽ и 15,75 ₽ за оплачиваемую секунду соответственно. Оплачиваемые секунды считаются как max(duration + ceil(суммарная длительность референсов), ceil(5 × duration / 3)). Например, 10 секунд результата и 10 секунд референса стоят 140 ₽ в 480p или 315 ₽ в 720p, а 10 секунд без видеовхода — 115 ₽ или 261 ₽. Также снижены базовые ставки Fast и Mini; полная таблица — в тарифах Seedance.

3. Фиксированная цена за аудиозапрос

suno-v6 списывается один раз за запрос и возвращает два трека. Текущая ставка — 6,65 ₽; она также доступна в каталоге.

4. Токены текстовых моделей

Для POST /v1/chat/completions стоимость считается по фактическому usage: отдельно вход, выход, чтение и создание кеша. Кешированные токены оплачиваются по соответствующим ставкам кеша, а не повторно как обычный вход. Перед запросом резервируется оценочная сумма, после ответа она сверяется с фактическим расходом токенов.

Для gpt-6-luna, gpt-6-sol и gpt-6.1-sol действуют два диапазона:

  • До 272 000 входных токенов включительно: обычные ставки.
  • Свыше 272 000 входных токенов: вход, чтение и создание кеша x2, выход x1,5. Повышенные ставки применяются ко всему запросу, а не только к превышению порога.

Диапазон выбирается по usage.prompt_tokens до вычета кеша. Выходные токены не участвуют в определении порога. Для запросов до порога цена не изменилась.

Таблицы базовых и повышенных цен GPT-6, а также актуальные цены Claude, включая Fable 5, находятся в тарифах текстовых моделей. Точные значения доступны в GET /public/models; повышенные ставки GPT-6 - в поле longContextPricing.

Персональные цены

Для крупных клиентов мы можем назначить персональную цену на конкретные модели — она применяется поверх дефолтной. Если у тебя такой кейс — напиши в @apinexusbuy.

Что происходит при провале

Когда задача переходит в failed:

  1. Запрос провайдеру не успел, или ответ — ошибка.
  2. Сумма hold’а возвращается на тот же ключ, с которого создавали.
  3. В error — человекочитаемое описание (см. Ошибки).

То есть за провалы ты не платишь. Это касается всех типов ошибок: и сетевых проблем у провайдера, и rejected-промптов, и моделей, которые отказались генерить из-за safety-фильтра.

Где смотреть свои списания

В panel.nexusapi.dev:

  • Dashboard — суммарно за 30 дней, разбивка по моделям, общая сумма
  • API ключи — баланс каждого ключа, сколько потрачено LTV
  • Запросы (логи) — каждая задача с моделью и стоимостью
  • Биллинг — история транзакций (топ-апы и корректировки)