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

Биллинг

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

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

  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-семействам. В каталоге цена дана за секунду, 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

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

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

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

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

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

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

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

В panel.nexusapi.dev:

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