Albato
Подключение Hubris к Albato — приложение с действиями «Отправить сообщение модели», «Список моделей» и «Эмбеддинг текста», плюс универсальный путь через HTTP-запрос.
Albato — платформа автоматизации с российскими сервисами в каталоге: Битрикс24, amoCRM, МойСклад, Яндекс.Формы, Telegram. Сценарии собираются мышкой, без кода. Hubris подключается двумя способами:
- Приложение Hubris — три действия: отправка запроса к модели, получение каталога моделей и эмбеддинг текста. Список моделей подтягивается из вашего аккаунта, поэтому в выпадающем меню всегда актуальные названия.
- HTTP-запрос — универсальный путь: работает с любым нашим эндпоинтом, включая те, которых нет в приложении (озвучка, транскрибация, генерация изображений, видео).
Приложение Hubris отправлено в каталог Albato и проходит модерацию — в поиске приложений оно появится после публикации. До этого момента работает второй путь, HTTP-запрос: он описан ниже и покрывает те же операции.
Требования
Создание подключения
Подключение создаётся один раз и переиспользуется во всех действиях сценария.
- Добавьте в сценарий любое действие Hubris.
- В поле подключения нажмите создание нового.
- Вставьте API-ключ формата
sk-gw-...— создать его можно в личном кабинете. - Сохраните. Albato сразу проверит ключ запросом к нашему API: если подключение создалось, ключ рабочий.
Ключ хранится в подключениях Albato и в самом сценарии не показывается. Разумно завести под автоматизацию отдельный ключ с лимитом расхода — тогда ошибка в сценарии не съест весь баланс.
Действие «Отправить сообщение модели»
Отправляет запрос к языковой модели и возвращает текст. Подходит для ответов на заявки, пересказов, классификации обращений, генерации описаний товаров.
Поля
| Поле | Что задаёт |
|---|---|
| Модель | Выпадающий список моделей из вашего аккаунта. Идентификаторы вида anthropic/claude-sonnet-5 — вендор перед косой чертой обязателен. |
| Системная инструкция | Постоянная часть промпта: роль, тон, правила, формат ответа. Если оставить пустым, подставится нейтральное значение по умолчанию. |
| Сообщение | Основной запрос. Сюда подставляются данные предыдущих шагов сценария. |
| Температура | Разброс ответов, от 0 до 2. Ниже — предсказуемее, выше — свободнее. Пусто — значение модели по умолчанию. |
| Максимум токенов | Потолок длины ответа. Пусто — значение модели по умолчанию. |
Что возвращает
| Поле | Значение |
|---|---|
| Ответ модели | Текст ответа — то, что нужно в большинстве сценариев. |
| Токены на входе | Сколько токенов ушло на запрос. |
| Токены на выходе | Сколько токенов в ответе. |
Стоимость каждого запроса видна в логах, там же можно отфильтровать запросы по ключу, если под Albato заведён отдельный.
Действие «Список моделей»
Возвращает каталог моделей с идентификаторами и человеческими названиями. Полезно, когда модель выбирается не вручную, а по условию: например, дешёвая для типовых заявок и сильная для сложных.
Входных полей нет. На выходе — идентификатор и название модели.
Действие «Эмбеддинг текста»
Переводит текст в вектор для семантического поиска и сравнения. На вход — текст, на выходе — количество израсходованных токенов.
Сам вектор через это действие не возвращается: он состоит из полутора тысяч чисел, и конструктор Albato такой массив не разбирает. Когда вектор нужен целиком, вызывайте /v1/embeddings HTTP-запросом — как это сделать, ниже.
Универсальный путь: HTTP-запрос
Приложение закрывает текст и эмбеддинги. Всё остальное — озвучку, транскрибацию, генерацию изображений, видео, вызов инструментов, картинку на входе — берите штатным приложением HTTP Запрос с действием Отправить запрос:
URL: https://api.hubris.pw/v1/chat/completions
Метод запроса: POST
Заголовки:
Authorization: Bearer sk-gw-...
Content-Type: JSON
Параметры запроса (тело):
{
"model": "anthropic/claude-haiku-4.5",
"messages": [
{"role": "user", "content": "Текст из предыдущего шага"}
]
}Тело запроса Albato собирает из параметров, которые вы перечисляете в настройке действия: ключ, тип, значение. Поле messages — массив объектов, поэтому проверьте в подсказке конструктора, как задать вложенный параметр, или соберите JSON строкой в предыдущем шаге.
Ответ приходит в формате OpenAI: текст лежит в choices.0.message.content (вложенные поля — через точку, элементы массива нумеруются с нуля), расход токенов — в usage. Полный список эндпоинтов — в справочнике API.
Рекомендуемые модели
Сценарии автоматизации — это обычно поток однотипных запросов, где цена и скорость важнее предельного качества рассуждений.
| Модель | Когда уместна |
|---|---|
anthropic/claude-haiku-4.5 | классификация, короткие ответы, извлечение данных |
openai/gpt-4o-mini | универсальный недорогой выбор |
anthropic/claude-sonnet-5 | тексты, где виден стиль, и многошаговые задачи |
google/gemini-3.7-flash | длинные документы в контексте |
deepseek/deepseek-v4-flash-0731 | массовая обработка текста по минимальной цене |
Полный каталог с ценами — на странице Модели.
Решение проблем
Список моделей пустой
Приложение запрашивает каталог по вашему ключу. Пустой список означает, что запрос не прошёл: пересоздайте подключение с ключом заново и проверьте, что ключ не отозван в личном кабинете.
«Неверный API-ключ» (401)
Ключ не подошёл. Он должен начинаться с sk-gw- и не содержать пробелов и переносов строк — при копировании из мессенджера легко прихватить лишнее.
«Недостаточно баланса» (402)
Баланс кончился. Пополнить — в личном кабинете. Полезно включить автопополнение, чтобы ночной сценарий не встал на середине.
«Модель не найдена» (404)
Идентификатор должен совпадать с каталогом символ в символ, включая вендора перед косой чертой. Короткие имена без вендора мы не принимаем.
Превышен лимит ключа (429)
Это суточный лимит расхода, заданный для ключа: поднять или снять — в настройках ключа. Тот же код возвращается, когда частоту запросов ограничил производитель модели — тогда повторите позже или возьмите другую модель.
Что дальше
- Каталог моделей — какие модели доступны и сколько стоят
- Управление ключами — отдельный ключ под Albato с лимитом
- Расходы — во сколько обошлись прогоны сценариев
- Справочник API — эндпоинты для HTTP-запроса
Обновлено: