Daj przepływom Activepieces dostawcę AI kompatybilnego z OpenAI.

Szybka odpowiedź: jeden wpis dostawcy w konfiguracji AI panelu administracyjnego.

W konsoli administracyjnej Activepieces otwórz stronę konfiguracji AI i dodaj dostawcę typu OpenAI Compatible. Formularz przyjmuje Display Name, API Key, Base URL, API Key Header, opcjonalne domyślne nagłówki oraz listę modeli, gdzie każdy wpis ma Model ID, Model Name i Model Type. Wartości dla APIsRouter: Base URL to https://api.apisrouter.com/v1 (ten sam kształt, którego kodowa baza używa dla swoich własnych wbudowanych dostawców kompatybilnych), API Key Header to Authorization, a pole klucza przyjmuje Twój klucz bramki. Jeden szczegół implementacyjny wart poznania: Activepieces wysyła klucz w tym nagłówku dokładnie tak, jak go wpisałeś, bez automatycznego dodawania prefiksu Bearer, więc wpisz go jako "Bearer sk-..." dla kanonicznej formy; APIsRouter akceptuje też goły klucz w nagłówku Authorization, więc obie formy tutaj działają. Następnie dodaj każdy model, który mają widzieć przepływy, z Model ID dokładnie zgadzającym się z katalogiem.

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

Jak Activepieces wykorzystuje niestandardowego dostawcę.

Activepieces (około 23 tys. gwiazdek na GitHubie) to wiodąca open-source'owa platforma automatyzacji no-code: przepływy budowane z triggerów i pieces, w kształcie zbliżonym do Zapiera, ale z możliwością self-hostingu, z frameworkiem pieces na licencji MIT i dużym katalogiem społecznościowym. Jej możliwości AI (kroki generowania tekstu, agenci, narzędziowe pieces AI) rozwiązują swój model przez skonfigurowanych na platformie dostawców AI, co sprawia, że wpis dostawcy jest decyzją routingową dla wszystkich przepływów naraz. Pod maską dostawca OpenAI Compatible buduje standardowego klienta względem Twojego Base URL i dołącza Twój klucz pod wybraną przez Ciebie nazwą nagłówka, plus nagłówki metadanych per uruchomienie, identyfikujące projekt i przepływ. Zarejestrowany przez Ciebie Model ID jest przekazywany jako string modelu w żądaniach chat-completions. Ten typ dostawcy nie ma automatycznego wykrywania modeli: przepływy mogą wybierać dokładnie te modele, które dodałeś do listy, co utrzymuje picker celowym, a nie zalanym opcjami. Konfiguracja dostawcy jest na poziomie platformy. Administrator definiuje ją raz, a każdy projekt i przepływ w instancji wybiera spośród zarejestrowanych modeli. Ta centralizacja to zysk w zarządzaniu: jedno miejsce, żeby zdecydować, jakie modele istnieją, jeden klucz do mierzenia wszystkich kroków AI, a metadane per przepływ w każdym żądaniu sprawiają, że użycie jest przypisywalne, gdy czytasz logi.

Pełna konfiguracja i zastrzeżenie dotyczące zapisu.

Formularz zapisuje się bez walidacji połączenia; implementacja dostawcy jawnie pomija sprawdzanie połączenia dla typu OpenAI Compatible. To wygodne (brak odpytywania Twojego endpointu w momencie zapisu), ale oznacza, że błędny Base URL albo źle sformułowany klucz zawiedzie później, przy pierwszym uruchomieniu przepływu dotykającym kroku AI. Zweryfikuj endpoint ręcznie raz, zanim wpleciesz go w produkcyjne przepływy, i traktuj pierwsze uruchomienie jako część konfiguracji. Model Type ma znaczenie dla tego, które pieces mogą użyć wpisu: kroki tekstowe chcą modeli TEXT. Zarejestruj identyfikator dokładnie tak, jak zapisuje go katalog; Model Name to etykieta wyświetlana i może być dowolnie czytelna. Jeśli chcesz mieć ten sam bazowy model w dwóch poziomach cena/wydajność dla różnych zespołów, zarejestruj go raz na każdy Model ID; nazwy wyświetlane pozwolą je odróżnić w pickerze.

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"}]}'

Dobór modeli do kroków automatyzacji.

Ponieważ dostawca działa na poziomie całej platformy, zarządzanie modelami to jeden ekran: dodaj identyfikatory, które akceptujesz, obserwuj tydzień użycia per klucz i przytnij to, czego nikt nie powinien używać. Twórcy przepływów zachowują swobodę w ramach listy, którą wyselekcjonowałeś.

• AI w automatyzacji to praca wysokowolumenowa z krótkimi promptami: klasyfikacja zgłoszenia, wyodrębnianie pól, szkicowanie wiadomości, streszczanie payloadu webhooka. claude-haiku-4-5-20251001, gpt-5.4-mini i deepseek-v4-flash pokrywają większość kroków w cenach wolumenowych.
• Zarezerwuj silniejszy identyfikator dla kroków wymagających osądu. Przepływ, który szkicuje odpowiedzi widoczne dla klienta albo podejmuje decyzje routingowe, zasługuje na claude-sonnet-4-6, wybierany per krok w kreatorze przepływów.
• MiniMax-M2.7 i rodzina DeepSeek wyceniają się wyjątkowo dobrze dla masowych przepływów transformacji (feedy, czyszczenie danych ze scrapingu, wzbogacanie), gdzie tysiące uruchomień dziennie to norma.
• Przepływy działają bez nadzoru, więc koszt to harmonogram pomnożony przez liczbę tokenów na uruchomienie. Log użycia daje Ci liczbę per uruchomienie; harmonogram zależy od Ciebie.
• Rejestruj niewiele modeli, celowo. Picker pokazuje dokładnie to, co dodałeś, a wyselekcjonowana lista powstrzymuje setkę twórców przepływów przed wybieraniem za każdym razem czegoś innego.

Płatność za użycie · poniżej cen oficjalnych

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

Tryby awarii charakterystyczne dla Activepieces.

Cichy zapis, głośne pierwsze uruchomienie. Ponieważ dostawca OpenAI Compatible pomija walidację połączenia, każdy błąd okablowania (zły Base URL, brak /v1, zły klucz, zła nazwa nagłówka) ujawnia się jako nieudany krok AI w uruchomieniu przepływu, a nie błąd formularza. Gdy krok AI zawodzi zaraz po zmianach u dostawcy, podejrzewaj wpis dostawcy, zanim podejrzysz przepływ. Kwestia prefiksu Bearer. Klucz jest wysyłany dosłownie pod wybranym przez Ciebie nagłówkiem. Endpointy wymagające dosłownego prefiksu Bearer potrzebują go wpisanego w pole klucza; APIsRouter akceptuje obie formy, ale jeśli kiedykolwiek przekierujesz tego dostawcę gdzie indziej, pamiętaj, że platforma nie doda za Ciebie prefiksu. Identyfikatory modeli są dokładne. Zarejestrowany identyfikator z literówką przechodzi przez formularz (etykiety to dowolny tekst) i zawodzi w czasie działania z błędem model-not-found; wynik /v1/models bramki jest autorytatywnym zapisem. Brak automatycznego wykrywania to funkcja, nie błąd. Jeśli modelu brakuje w pickerze przepływu, nie został zarejestrowany u dostawcy; dodaj go w konsoli administracyjnej, zamiast szukać w kreatorze przepływów. I trzymaj w głowie osobno połączenia na poziomie pieces: pojedyncze pieces, takie jak piece OpenAI, mogą przechowywać własne poświadczenia per połączenie, podczas gdy opisany tu wpis dostawcy zasila uniwersalne możliwości AI platformy. Jeśli przepływ używa piece specyficznego dla dostawcy z własnym połączeniem, ten ruch nie jest kierowany przez Twój wpis bramki.

Kto kieruje Activepieces przez bramkę.

• Zespoły self-hostujące, które standaryzują AI w dziesiątkach przepływów, gdzie jeden wpis dostawcy i jeden klucz zastępują rozproszone poświadczenia per piece.
• Administratorzy platformy, którzy chcą zarządzania modelami: wyselekcjonowana lista modeli, użycie per klucz i możliwość podmiany endpointu bazowego bez dotykania przepływów.
• Agencje prowadzące automatyzacje klientów na jednej instancji, mierzące użycie AI per klient osobnymi kluczami na tym samym katalogu.
• Twórcy, których przepływy mieszają kroki wolumenowe z krokami wymagającymi osądu, łącząc szybkie identyfikatory z identyfikatorami frontier per krok przez jeden endpoint.
• Deweloperzy bez dostępu do rozliczeń danego dostawcy. Dostęp oparty na doładowaniu, bez wymogu karty, usuwa zależność od rejestracji u każdego dostawcy z osobna.

Zweryfikuj endpoint i debuguj pierwszy krok AI.

Uruchom oba powyższe curle przed zapisaniem dostawcy; dowodzą razem klucza, Base URL i identyfikatora modelu — dokładnie tego, czego formularz za Ciebie nie sprawdzi. Gdy krok AI przepływu zawodzi po konfiguracji, przeczytaj błąd kroku. Błędy uwierzytelniania oznaczają zły klucz albo złą nazwę nagłówka (albo brak prefiksu Bearer na endpoincie, który go wymaga). Błąd model-not-found to zarejestrowany identyfikator niezgodny z katalogiem. Błąd połączenia zwykle oznacza, że Base URL zgubił swoje /v1. Jeśli krok nie może znaleźć żadnego modelu do wyboru, dostawca się zapisał, ale lista modeli jest pusta dla tego typu modelu. Gdy przepływy już działają, konsola APIsRouter pokazuje model per żądanie, liczbę tokenów i wydatki. Zaplanowane automatyzacje kumulują się po cichu, a widok użycia per klucz to sposób, w jaki administrator platformy widzi, które przepływy zarabiają na swoje tokeny, zanim zrobi to faktura.

Częste pytania