API Qubu: как это работает и зачем бизнесу

1. API простыми словами: как курьер между двумя офисами

Представьте, что у вас есть две компании:

• Компания А: ваш сайт или приложение (например, интернет-магазин)

• Компания Б: Qubu с нашими мощностями и моделями

API — это курьер, который бегает между ними с конвертами.

text

[Ваш сайт] → (Курьер API) → [Qubu]
    ↑                                ↓
    ← (Курьер API) ← [Модель думает]

Как выглядит диалог:

1. Ваш сайт пишет письмо: «Уважаемый Qubu, у меня есть текст: "Как подключить API?". Используй модель Llama 3, отвечай вежливо. Твой API-ключ подтверждает, что это я».

2. Курьер доставляет письмо в Qubu.

3. Qubu проверяет ключ — пускать или нет.

4. Модель «думает» 1-3 секунды и пишет ответ.

5. Курьер везёт ответ обратно на ваш сайт.

6. Ваш сайт показывает ответ пользователю.

Всё. Никакой магии. API — просто способ передавать сообщения туда-обратно.

2. API-ключ: это как пропуск в офис

Когда вы регистрируетесь в Qubu, мы выдаём вам API-ключ. Это длинная строка букв и цифр, например:

text

qubu_live_8f9a3d2c1e4b5a6d7c8b9a0e

Что можно сделать с ключом:

Где хранить ключ:

Золотое правило:

API-ключ — как пароль от онлайн-банка. Никому его не показывайте и не храните в открытом виде.

3. Что такое «токены» и почему мы платим за них

Модели не умеют читать буквы. Они умеют читать токены.

Токен — это кусочек слова.

Как считаются деньги:

text

Ваш запрос (входящие токены) + Ответ модели (исходящие токены) = Цена

Пример для реальной задачи:

Вывод для бизнеса: один диалог с ИИ стоит копейки. Дешевле, чем отправить SMS.

4. Синхронный и асинхронный режимы: когда ждать, когда не ждать

Синхронный режим — «Спросил — сразу ответили»

• Вы отправили запрос

• Модель думает 1-3 секунды

• Вы получаете ответ

Когда использовать: чат-бот на сайте, быстрые вопросы, генерация коротких текстов.

Асинхронный режим — «Спросил — получил номер заказа, заберу позже»

• Вы отправили запрос

• Qubu говорит: «Ваш номер задачи 12345»

• Вы идёте пить чай (модель думает 30 секунд — 2 минуты)

• Вы забираете результат по номеру задачи

Когда использовать: генерация изображений, видео, аудио, анализ больших документов (100+ страниц).

Сравнение:

5. Чек-лист для первого подключения к API Qubu (для менеджера)

Этот чек-лист вы можете отдать разработчику или выполнить сами, если у вас есть технический сотрудник.

Этап 1. Подготовка (делаете вы в личном кабинете Qubu)

• Зарегистрировались на платформе Qubu

• Пополнили баланс (начальный — 500-1000 ₽ для тестов)

• Создали API-ключ в разделе «Настройки»

• Скопировали ключ в безопасное место (пароль от Qubu — в менеджере паролей)

Этап 2. Передача разработчику (даёте ему документ)

• API-ключ

• Название модели, которую хотите использовать (например, «llama-3-8b»)

• Описание задачи: «Чат-бот отвечает на вопросы про доставку»

• Адрес API: https://api.qubu.ai/v1/inference

Этап 3. Тестирование (проверяете вместе с разработчиком)

• Отправили первый тестовый запрос (например, «Привет, как дела?»)

• Получили ответ от модели

• Проверили, что в личном кабинете появилась статистика по этому вызову

• Сравнили списание с баланса с ожидаемой ценой

Этап 4. Продакшен (запуск на реальных пользователях)

• Установили дневной лимит расходов (чтобы не уйти в минус)

• Настроили мониторинг ошибок (чтобы знать, если API не работает)

• Сделали fallback — если API не отвечает, пользователь видит «Технические работы, попробуйте позже»

6. Сколько стоит запустить чат-бота на 10 000 пользователей

Давайте посчитаем реалистичный бюджет для небольшого интернет-магазина.

Исходные данные:

Расчёт:

24 рубля в месяц. За автоматизацию поддержки 2000 клиентов.

Да, вы не ослышались. Это дешевле, чем зарплата менеджера за 15 минут работы.

Итог урока