Подключите флоу Activepieces к OpenAI-совместимому AI-провайдеру.

Короткий ответ: одна запись провайдера в admin AI setup.

В админ-консоли Activepieces откройте страницу AI setup и добавьте провайдера типа OpenAI Compatible. Форма принимает Display Name, API Key, Base URL, API Key Header, опциональные default headers и список моделей, где у каждой записи есть Model ID, Model Name и Model Type. Значения для APIsRouter: Base URL — https://api.apisrouter.com/v1 (та же форма, которую кодовая база использует для собственных встроенных совместимых провайдеров), API Key Header — Authorization, а в поле ключа идёт ваш ключ шлюза. Одна деталь реализации, которую стоит знать: Activepieces отправляет ключ в этом заголовке ровно так, как вы его ввели, без автоматического добавления префикса Bearer, так что вводите его как «Bearer sk-...» для канонической формы; APIsRouter также принимает голый ключ в заголовке Authorization, так что оба написания работают здесь. Затем добавьте каждую модель, которую должны видеть флоу, с Model ID, точно совпадающим с каталогом.

Admin Console -> AI setup -> Add AI Provider
  -> OpenAI Compatible

Display Name:   APIsRouter
Base URL:       https://api.apisrouter.com/v1
API Key Header: Authorization
API Key:        Bearer sk-YOUR-APISROUTER-KEY

Models (Add Model):
  Model ID: claude-haiku-4-5-20251001  Type: TEXT
  Model ID: deepseek-v4-flash          Type: TEXT
  Model ID: claude-sonnet-4-6          Type: TEXT

Как Activepieces использует кастомного провайдера.

Activepieces (около 23K звёзд на GitHub) — ведущая open-source no-code платформа автоматизации: флоу, построенные из триггеров и pieces, в духе Zapier, но с возможностью self-hosting, с MIT-лицензированным фреймворком pieces и большим каталогом от сообщества. Её AI-возможности (шаги генерации текста, агенты, AI utility pieces) резолвят свою модель через настроенных на платформе AI-провайдеров, из-за чего запись провайдера становится решением о маршрутизации сразу для всех флоу. Под капотом провайдер OpenAI Compatible строит стандартный клиент к вашему Base URL и прикрепляет ваш ключ под выбранным именем заголовка, плюс заголовки метаданных на каждый прогон, идентифицирующие проект и флоу. Зарегистрированный Model ID передаётся как строка модели в запросах chat-completions. Для этого типа провайдера нет автообнаружения моделей: флоу могут выбирать ровно те модели, которые вы добавили в список, что делает селектор осознанным, а не переполненным. Настройка провайдера — на уровне платформы. Админ задаёт её один раз, и каждый проект и флоу в инстансе выбирают из зарегистрированных моделей. Эта централизация — выигрыш в управляемости: одно место, чтобы решить, какие модели существуют, один ключ, чтобы измерять все AI-шаги, и метаданные по каждому флоу в каждом запросе, которые делают использование атрибутируемым при чтении логов.

Полная настройка и нюанс момента сохранения.

Форма сохраняется без валидации подключения; реализация провайдера явно пропускает проверки подключения для типа OpenAI Compatible. Это удобно (никакого прощупывания вашего эндпоинта в момент сохранения), но означает, что неверный Base URL или испорченный ключ дадут сбой позже — на первом прогоне флоу, который затрагивает AI-шаг. Проверьте эндпоинт вручную один раз, прежде чем встраивать его в продакшн-флоу, и относитесь к первому прогону как к части настройки. Model Type важен для того, какие pieces могут использовать запись: текстовым шагам нужны модели TEXT. Регистрируйте id ровно так, как его пишет каталог; Model Name — это отображаемая метка и может быть любой читаемой строкой. Если вы хотите одну и ту же базовую модель на двух ценовых уровнях для разных команд, зарегистрируйте её отдельно под каждым Model ID; отображаемые имена сохранят их различимыми в селекторе.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

Выбор моделей для шагов автоматизации.

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

• AI в автоматизации — это высокообъёмная работа с короткими промптами: классифицировать тикет, извлечь поля, составить черновик сообщения, суммаризировать payload вебхука. claude-haiku-4-5-20251001, gpt-5.4-mini и deepseek-v4-flash покрывают большинство шагов по объёмным ценам.
• Держите более сильный id для шагов, требующих суждения. Флоу, который составляет черновики ответов для клиентов или принимает решения о маршрутизации, заслуживает claude-sonnet-4-6, выбираемого по шагам в конструкторе флоу.
• MiniMax-M2.7 и семейство DeepSeek оцениваются крайне выгодно для массовых флоу трансформации (фиды, чистка после скрапинга, обогащение данных), где тысячи прогонов в день — норма.
• Флоу работают без присмотра, так что стоимость — это расписание, умноженное на количество токенов за прогон. Лог использования даёт вам число за прогон; расписание — на вашей стороне.
• Регистрируйте немного моделей и осознанно. Селектор показывает ровно то, что вы добавили, а курируемый список не даёт сотне разработчиков флоу каждый раз выбирать что-то своё.

Оплата по факту · дешевле официальных цен

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Сбои, специфичные именно для Activepieces.

Тихое сохранение, громкий первый прогон. Поскольку провайдер OpenAI Compatible пропускает валидацию подключения, любая ошибка в настройке (неверный Base URL, отсутствующий /v1, неверный ключ, неверное имя заголовка) проявляется как упавший AI-шаг в прогоне флоу, а не как ошибка формы. Если AI-шаг падает сразу после изменений провайдера, подозревайте в первую очередь запись провайдера, а не флоу. Вопрос префикса Bearer. Ключ отправляется дословно под выбранным вами заголовком. Эндпоинтам, требующим буквального префикса Bearer, он нужен вписанным прямо в поле ключа; APIsRouter принимает обе формы, но если вы когда-нибудь перенаправите этого провайдера куда-то ещё, помните: платформа не добавит префикс за вас. Model IDs — это точные строки. Зарегистрированный id с опечаткой проходит форму (метки — это свободный текст) и падает во время выполнения с ошибкой model-not-found; вывод /v1/models шлюза — авторитетное написание. Отсутствие автообнаружения — это фича, а не баг. Если модели нет в селекторе флоу, значит, она не была зарегистрирована у провайдера; добавьте её в админ-консоли, а не ищите проблему в конструкторе флоу. И держите в голове отдельно подключения на уровне pieces: отдельные pieces вроде OpenAI piece могут хранить собственные credentials на подключение, тогда как описанная здесь запись провайдера питает универсальные AI-возможности платформы. Если флоу использует специфичный для вендора piece с собственным подключением, этот трафик не идёт через вашу запись шлюза.

Кто направляет Activepieces через шлюз.

• Команды на self-hosting, стандартизирующие AI на десятках флоу, где одна запись провайдера и один ключ заменяют разрозненные credentials на каждый piece.
• Админы платформы, которым нужно управление моделями: курируемый список моделей, использование по ключу и возможность сменить эндпоинт за кулисами, не трогая флоу.
• Агентства, ведущие клиентские автоматизации на одном инстансе, измеряя использование AI по клиенту через отдельные ключи на одном и том же каталоге.
• Разработчики, чьи флоу смешивают объёмные шаги и шаги, требующие суждения, сочетая быстрые id с топовыми id по шагам через один эндпоинт.
• Разработчики без доступа к биллингу конкретного вендора. Доступ на основе пополнения без требования карты убирает зависимость от регистрации у каждого провайдера.

Проверьте эндпоинт и отладьте первый AI-шаг.

Прогоните два curl-запроса выше перед сохранением провайдера; вместе они доказывают ключ, Base URL и id модели — именно то, что форма не проверит за вас. Когда AI-шаг флоу падает после настройки, читайте ошибку шага. Сбои аутентификации означают, что поле ключа или имя заголовка неверны (или на эндпоинте, который его требует, отсутствует префикс Bearer). Ошибка model-not-found — это зарегистрированный id, не совпадающий с каталогом. Ошибка подключения обычно означает, что Base URL потерял свой /v1. Если шаг не может найти ни одной модели для выбора, провайдер сохранился, но список моделей для этого типа модели пуст. Как только флоу начинают работать, консоль APIsRouter показывает модель на запрос, счётчики токенов и расходы. Запланированные автоматизации накапливаются тихо, и вид использования по ключу — это то, как админ платформы видит, какие флоу отрабатывают свои токены, ещё до того, как это увидит счёт.

Частые вопросы