Підключіть флоу 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 (близько 23 тис. зірок на 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 показує модель на запит, кількість токенів і витрати. Заплановані автоматизації накопичуються тихо, і погляд на використання за ключем — це те, як адмін платформи бачить, які флоу відпрацьовують свої токени, ще до того, як це побачить рахунок.

Поширені запитання