Биллинг
Базовая модель
Стоимость считается в рублях, балансе ключа. Поток:
- Ты делаешь
POST /generate— мы оцениваем стоимость и резервируем (hold) её на балансе. - Если баланса не хватает —
402 Payment Required, задача не создаётся. - Если хватает — задача создаётся, баланс уменьшается, в очередь уходит сообщение.
- При
failed— стоимость возвращается на ключ автоматически. - При
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-masterkling-o1,kling-o1-edit,kling-o3,kling-o3-pro,kling-v3,kling-v3-prokling-v2.6-motion-720p,kling-v2.6-motion-1080pseedance-2.0,seedance-2.0-pro,seedance-2.0-mini,seedance-2.0-fast,seedance-2.5,seedance-2.0-eco,seedance-2.5-ecowan-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:
- Запрос провайдеру не успел, или ответ — ошибка.
- Сумма hold’а возвращается на тот же ключ, с которого создавали.
- В
error— человекочитаемое описание (см. Ошибки).
То есть за провалы ты не платишь. Это касается всех типов ошибок: и сетевых проблем у провайдера, и rejected-промптов, и моделей, которые отказались генерить из-за safety-фильтра.
Где смотреть свои списания
- Dashboard — суммарно за 30 дней, разбивка по моделям, общая сумма
- API ключи — баланс каждого ключа, сколько потрачено LTV
- Запросы (логи) — каждая задача с моделью и стоимостью
- Биллинг — история транзакций (топ-апы и корректировки)