// модуль платформы · MBC AI Platform

Шлюз к ИИ-моделям: один ключ, баланс и учёт каждого вызова

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

тип
Модуль платформы MBC
задачи
тексты · статьи · изображения · речь
документация
ai.mbc-apps.com/docs ↗

путь одного запроса: кто кому что передаёт

Ваш сервисмагазин, блог, учёт
MBC AI Platformшлюз
Провайдер моделейвнешний сервис
  1. Запрос и ключ платформы
  2. Проверка. Ключ действует, эта услуга или модель открыта аккаунту.
  3. Удержание. С баланса удержана оценка стоимости. Не хватило — отказ, модель не вызывается.
  4. Вызов модели ключом студии
  5. Ответ и число токенов
  6. Списание по факту. Остаток удержания возвращён на баланс.
  7. Результат
8 · запись в журналеаккаунт «Магазин»ключ «каталог»метка «карточки»модельтокенысписано
Жёлтая точка — запрос, зелёная — ответ. Сервис не хранит ключи провайдера и не считает токены: он получает результат, а расход уже записан на его аккаунт. Названия в журнале условные.
01 / задача

Модели нужны многим проектам, а счёт за них приходит один

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

Если подключать модели в каждом проекте отдельно, одни и те же вопросы возникают снова:

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

MBC AI Platform решает это один раз. Сервис получает ключ платформы и адрес, остальное происходит внутри шлюза.

02 / как обратиться

Два входа: готовая услуга или модель напрямую

вход 1 · готовая услуга

Задача целиком

Сервис передаёт данные по контракту услуги и получает строгий результат: текст или JSON по схеме. Промпты, шаги и модель уже подобраны.

# создать задание и дождаться результата
POST /api/v1/generations
X-Api-Key: mdp_…
Idempotency-Key: card-4821

{ "channel": "product_card",
  "input": { "title": "Кофеварка рожковая" } }
вход 2 · прямой доступ

Модель по протоколу OpenAI

Готовые библиотеки работают после замены адреса и ключа. Учёт, удержание и журнал остаются на стороне платформы.

# официальная библиотека, другой адрес
client = OpenAI(
  base_url="https://ai.mbc-apps.com/api/v1",
  api_key="mdp_…")

client.chat.completions.create(
  model="…", messages=[…], user="карточки")
03 / готовые услуги

Что подаём и что получаем

Карточка товара

вход
название и подсказки
выход
описание, характеристики и данные для поисковиков

Статья

вход
тема и пожелания
выход
сначала план, после правки человеком — текст

Изображение

вход
описание картинки
выход
готовый файл

Расшифровка

вход
аудиозапись
выход
текст

План и текст статьи — две отдельные услуги: между ними редактор правит план, и за план не удерживается стоимость всей статьи. О готовности долгой задачи платформа может сообщить сервису сама, подписанным уведомлением.

04 / деньги

Что происходит с балансом за один вызов

до вызова

Весь баланс доступен

доступно 100

Сервис отправил запрос. Платформа ещё ничего не тронула.

пока модель отвечает

Часть удержана

доступно 70удержано 30

Удержание — оценка с запасом. Эти деньги не потратит другой запрос.

после ответа

Списано по факту

доступно 79списано 21

Вызов стоил меньше оценки. Разница вернулась на баланс.

книга операций аккаунта · тот же вызов
операциясуммадоступно
Удержание перед вызовомоценка стоимости с запасом−3070
Списание по фактуиз удержанных 30 потрачено 212170
Возврат остатка удержания30 − 21+979

Числа условные и показывают только порядок операций. Записи в книге не исправляются и не удаляются — только добавляются.

Не хватило балансаЗапрос отклоняется до вызова модели. Ничего не списывается.
Модель не ответилаПлатформа повторяет вызов. Если не получилось — удержание возвращается.
Сервис повторил запросС тем же ключом идемпотентности вернётся прежний ответ, без второго списания.
Клиент пополнил балансИз кабинета MBC Harbor, из средств проекта. В книге появляется строка пополнения.
05 / доступ

Кто что видит

ключ платформы

Ваш сервис

  • каталог услуг и моделей
  • результат и статус задачи
  • сколько списано за вызов
  • ключей провайдера не видит
кабинет MBC Harbor

Клиент

  • баланс на ИИ
  • пополнение из средств проекта
  • в панель платформы не заходит
панель платформы

Оператор студии

  • аккаунты и именованные ключи
  • услуги и каталог моделей
  • журнал вызовов и задания по шагам
  • расходы по аккаунту, ключу, метке и дню
внешний сервис

Провайдер моделей

  • текст запроса
  • не знает, чей это запрос
  • метка учёта не передаётся

При прямом доступе к модели платформа не хранит тексты запросов: в журнал попадают аккаунт, ключ, метка, модель, токены и стоимость.

06 / где работает

Модуль уже встроен в проекты студии

В интернет-магазине электроники через платформу работают ИИ-интеграции для контента: результат проверяет и утверждает человек. На платформе автопубликации статей через неё пойдут планы и тексты статей.

В кабинете MBC Harbor клиент видит баланс на ИИ и пополняет его из средств проекта.

Когда мы начинаем новый проект, доступ к моделям в нём уже есть: нужно выпустить ключ и выбрать услугу.

07 / как подключить

Модуль подключаем по вашему желанию

вариант 1 · с поддержкой студии

Всё включено — интеграции на нас

Если вы остаётесь с нами на поддержке, модули платформы уже входят в проект. Уведомления, вход, ИИ-сервис и кабинет работают с первого дня, и вам не нужно в них разбираться.

  • сами следим за интеграциями и обновляем их
  • узнаём о сбое раньше вас и чиним без запроса
  • запуск быстрее: проект стартует с рабочей основы
  • один подрядчик отвечает за всё целиком
вариант 2 · независимая система

Полностью ваша — без привязки к студии

Если вы планируете дальше развивать и поддерживать сервис своей командой, соберём его автономным: без модулей нашей платформы и без зависимости от нас.

  • размещение на вашей инфраструктуре
  • исходный код и документация передаются вам
  • нужные функции встроены в саму систему
  • сопровождать сможет любая команда разработки

Модули платформы — возможность, а не условие. Формат обсуждаем до начала работ и закрепляем в предложении.

08 / под капотом
стек: Java 21, Spring Boot · PostgreSQL · React, TypeScript
деньги: книга операций только на добавление; условия расчёта фиксируются в момент создания задачи
безопасность: ключи провайдера зашифрованы в базе, события для вашего сервиса подписаны
для разработчиков: описание API в формате OpenAPI; совместимость с протоколом OpenAI проверяется тестами на официальной библиотеке

Нужен ИИ в вашей системе? Напишите в Telegram

Подключим ваш сервис к готовому шлюзу или сделаем систему, в которой расходы на модели видны с первого дня.

Написать в Telegram