Шлюз для агентств и фрилансеров: биллинг по клиентам

Если вы ведёте несколько проектов на нейросетях — агентство с пятью клиентами или фрилансер, который сдаёт результат под разные бюджеты, — общий счёт с одним ключом на всё быстро превращается в задачу «разберись потом, кто сколько потратил». У шлюза для этого есть конкретные инструменты, а не только один общий баланс на аккаунт.

Один ключ на клиента, а не один ключ на всё

Ключи fetch_... создаются в кабинете на странице https://zukko.pro/app/api-keys↗, и ничего не мешает завести отдельный ключ под каждого клиента или проект. Это не формальность, но учтите: история в /v1/usage общая на аккаунт (все ключи вместе, фильтра по ключу нет), и баланс тоже один на аккаунт. Разделять расход по клиентам удобно по заголовку X-Zukko-Cost-Micros — в каждом обычном (не потоковом) ответе он показывает стоимость именно этого вызова; если логировать его у себя вместе с ключом, которым сделан запрос, вы получаете точную цифру для выставления счёта без ручного разбора общего лога. У потоковых ответов (stream: true) этого заголовка нет — если нужна строгая раздельность и для них, заведите под клиента отдельный аккаунт.

curl https://api.zukko.pro/v1/usage \
  -H "Authorization: Bearer fetch_ваш_ключ"

Курсорная пагинация в /v1/usage позволяет забирать историю списаний всего аккаунта порциями — удобно, если строите собственный отчёт за период вместо того, чтобы смотреть цифры глазами.

Лимиты как страховка, а не только как экономия

На каждом ключе в кабинете можно задать дневной и месячный лимит расхода в долларах и список разрешённых моделей. Для агентства это работает как страховка от двух разных проблем:

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

Вторая — если клиент оплатил доступ только к определённому классу моделей (скажем, glm-5.3-flash и glm-5.3, но не claude-opus-5-5), список разрешённых моделей на ключе не даст случайно откатиться на дорогую модель посреди проекта. Попытка вызвать запрещённую модель вернёт понятную ошибку 403 model_not_allowed_for_key, а не тихое превышение бюджета.

Идемпотентность важна именно в автоматизации на клиентов

Агентские пайплайны, которые генерируют контент или отчёты для клиентов по расписанию, обычно включают ретраи на сетевые сбои. Без Idempotency-Key (уникального на каждый логический запрос и одинакового при его повторах) каждый ретай после ответа, который реально дошёл, но не был получен клиентским кодом, — это повторное списание с чужого клиентского бюджета. С заголовком повтор в течение 24 часов просто возвращает тот же сохранённый результат бесплатно. Для биллинга по клиентам это не мелочь: разница между «правильно посчитанный расход» и «случайно задвоенный счёт» здесь прямо влияет на маржу.

Кэш экономит на шаблонных задачах

Если часть работы для клиентов типовая — одинаковые проверки, повторяющиеся классификации одного и того же контента, шаблонные генерации — включайте кэш заголовком X-Zukko-Cache: true (temperature: 0 тоже включает кэш, но только у моделей, которые его принимают, — модели Claude могут отклонить temperature, отличный от 1). Повтор полностью идентичного запроса (совпадает всё тело) в течение 7 суток (для чата) возвращается мгновенно и бесплатно с пометкой X-Zukko-Cache: hit. При объёме в несколько клиентских проектов это реальная экономия, а не теоретическая возможность.

Реферальная программа как источник дохода, а не только скидка

Если вы приводите других фрилансеров или агентства на платформу, реферальная программа начисляет 10% с пополнений приглашённых — это можно использовать как дополнительный источник дохода при масштабировании собственной практики, а не только как разовый бонус.

Оплата под международных клиентов

Для расчётов доступны СБП, банковская карта через PayPear, крипта, а с 2026-09-16 — иностранная карта Mastercard EU через Fride (комиссия около 13%, суммы от $2 до $594; минимальное пополнение остальными способами — $1). Это важно, если часть клиентов или собственная команда работает за пределами России и нужен способ пополнения без локальной карты.

Разделение по языку и документации

Сайт двуязычный: русская версия на корне, английская — под /en. Если сдаёте отчётность или документацию клиенту на английском, можно сразу ссылаться на нужную языковую версию страниц кабинета и документации, не переводя вручную.

Чего шлюз не делает за вас

Стоит понимать границы: шлюз не выставляет клиенту счёт сам и не строит готовый дашборд с разбивкой по проектам — он даёт точные первичные данные (ключи, лимиты, историю /v1/usage, заголовки стоимости на каждый запрос), а свести их в отчёт для клиента или в собственную биллинговую систему нужно самостоятельно. Для агентства с небольшим числом клиентов обычно достаточно таблицы, куда раз в неделю сводятся ваши логи X-Zukko-Cost-Micros по ключам и сверяются с общей историей /v1/usage; при росте числа проектов имеет смысл написать небольшой скрипт, который делает это автоматически и складывает данные в свою базу.

Практическая схема на старте

1. Завести отдельный ключ на каждого активного клиента через https://zukko.pro/app/api-keys↗.
2. Выставить дневной/месячный лимит по бюджету клиента и список разрешённых моделей.
3. Включить Idempotency-Key (свой на каждый логический запрос) в автоматизации, где есть ретраи.
4. Логировать X-Zukko-Cost-Micros по ключу у себя и раз в отчётный период сверять сумму с общей историей /v1/usage перед счётом клиенту.
5. Для вопросов по биллингу или сбоям — поддержка в Telegram: https://t.me/zukkopro?direct↗.

Такая схема не требует ничего сверх того, что уже есть в кабинете и API — просто раскладывает существующие инструменты по клиентам вместо одного общего аккаунта на всё.