Geef Activepieces-flows een OpenAI-compatibele AI-provider.

Snel antwoord: één providervermelding in de admin AI-instellingen.

Open in de Activepieces admin-console de AI setup-pagina en voeg een provider van het type OpenAI Compatible toe. Het formulier vraagt een Display Name, een API Key, een Base URL, een API Key Header, optionele default headers, en een modellijst waarbij elke vermelding een Model ID, een Model Name, en een Model Type heeft. De waarden voor APIsRouter: Base URL is https://api.apisrouter.com/v1 (dezelfde vorm die de codebase gebruikt voor zijn eigen ingebouwde compatibele providers), API Key Header is Authorization, en het sleutelveld neemt je gatewaysleutel. Eén implementatiedetail dat het waard is om te weten: Activepieces stuurt de sleutel exact zoals getypt onder die header, zonder automatisch een Bearer-voorvoegsel toe te voegen, dus voer hem in als "Bearer sk-..." voor de canonieke vorm; APIsRouter accepteert hier ook de kale sleutel in de Authorization-header, dus beide schrijfwijzen werken. Voeg vervolgens elk model toe dat flows moeten zien, met een Model ID dat exact overeenkomt met de catalogus.

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

Hoe Activepieces een aangepaste provider gebruikt.

Activepieces (ruim 23K sterren op GitHub) is het toonaangevende open-source no-code automatiseringsplatform: flows opgebouwd uit triggers en pieces, in de vorm van Zapier maar self-hostable, met een MIT-gelicentieerd piece-framework en een grote community-catalogus. De AI-mogelijkheden (tekstgeneratiestappen, agents, AI-utility pieces) herleiden hun model via de geconfigureerde AI-providers van het platform, en dat maakt de providervermelding tot een routeringsbeslissing voor alle flows tegelijk. Onder de motorkap bouwt de OpenAI Compatible provider een standaardclient tegen je Base URL en hangt hij je sleutel onder de gekozen headernaam, plus metadataheaders per run die het project en de flow identificeren. Het Model ID dat je registreerde wordt doorgegeven als de model-string in chat-completions-verzoeken. Er is geen model-auto-discovery voor dit providertype: flows kunnen precies de modellen selecteren die je aan de lijst toevoegde, wat de kiezer doelgericht houdt in plaats van overvol. Providerconfiguratie is platformniveau. Een admin definieert het eenmaal, en elk project en elke flow op de instantie kiest uit de geregistreerde modellen. Die centralisatie is de governance-winst: één plek om te beslissen welke modellen bestaan, één sleutel om alle AI-stappen te meten, en de metadata per flow in elk verzoek maakt gebruik toewijsbaar wanneer je de logs leest.

Volledige instelling en de valkuil bij het opslaan.

Het formulier slaat op zonder de verbinding te valideren; de providerimplementatie slaat de verbindingscontrole voor het OpenAI Compatible type expliciet over. Dat is handig (geen sondering van je endpoint op het moment van opslaan), maar het betekent dat een verkeerde Base URL of een misvormde sleutel pas later faalt, bij de eerste flow-run die een AI-stap raakt. Verifieer het endpoint eenmalig handmatig voordat je het in productieflows verwerkt, en behandel de eerste run als onderdeel van de instelling. Model Type bepaalt wat pieces met de vermelding kunnen doen: tekststappen willen TEXT-modellen. Registreer het ID exact zoals de catalogus het spelt; de Model Name is een weergavelabel en mag alles leesbaars zijn. Als je hetzelfde onderliggende model op twee prijs-prestatieniveaus wilt voor verschillende teams, registreer het dan eenmaal per Model ID; de weergavenamen houden ze onderscheidbaar in de kiezer.

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

Modellen kiezen voor automatiseringsstappen.

Omdat de provider platformbreed is, is modelgovernance één scherm: voeg de ID's toe die je goedkeurt, bekijk een week gebruik per sleutel, en snoei wat niemand zou moeten gebruiken. Flowbouwers behouden hun vrijheid binnen de lijst die jij samenstelde.

• Automatisering-AI is werk met hoog volume en korte prompts: classificeer een ticket, extraheer velden, stel een bericht op, vat een webhook-payload samen. claude-haiku-4-5-20251001, gpt-5.4-mini en deepseek-v4-flash dekken de meeste stappen tegen volumeprijzen.
• Reserveer een sterker ID voor stappen die beoordelingsvermogen vergen. Een flow die klantgerichte antwoorden opstelt of routeringsbeslissingen neemt, verdient claude-sonnet-4-6, per stap gekozen in de flowbuilder.
• MiniMax-M2.7 en de DeepSeek-familie zijn uitstekend geprijsd voor bulk-transformatieflows (feeds, scraping-opschoning, verrijking) waar duizenden runs per dag normaal zijn.
• Flows draaien onbewaakt, dus de kosten zijn een schema vermenigvuldigd met een tokenaantal per run. Het gebruikslogboek geeft je het aantal per run; het schema is aan jou.
• Registreer weinig modellen, doelbewust. De kiezer toont precies wat je toevoegde, en een gecureerde lijst voorkomt dat honderd flowbouwers elk iets anders kiezen.

Betaal naar gebruik · onder officiële prijzen

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

Faalmodi specifiek voor Activepieces.

Stil opslaan, luide eerste run. Omdat de OpenAI Compatible provider verbindingsvalidatie overslaat, komt elke bekabelingsfout (verkeerde Base URL, ontbrekende /v1, foute sleutel, verkeerde headernaam) naar boven als een mislukte AI-stap in een flow-run in plaats van een formulierfout. Wanneer een AI-stap direct na providerwijzigingen faalt, verdenk dan eerst de providervermelding, niet de flow. De Bearer-voorvoegsel-vraag. De sleutel wordt verbatim verstuurd onder je gekozen header. Endpoints die het letterlijke Bearer-voorvoegsel vereisen, hebben het nodig getypt in het sleutelveld; APIsRouter accepteert beide vormen, maar als je deze provider ooit elders naartoe herwijst, onthoud dan dat het platform het voorvoegsel niet voor je toevoegt. Model-ID's zijn exact. Een geregistreerd ID met een tikfout passeert het formulier (labels zijn vrije tekst) en faalt tijdens runtime met model-not-found; de /v1/models-output van de gateway is de gezaghebbende spelling. Geen auto-discovery is een feature, geen bug. Als een model ontbreekt in de kiezer van een flow, is het niet geregistreerd op de provider; voeg het toe in de admin-console in plaats van te zoeken in de flowbuilder. En houd piece-niveau verbindingen apart in je hoofd: individuele pieces zoals de OpenAI-piece kunnen hun eigen credentials per verbinding hebben, terwijl de hier beschreven providervermelding de universele AI-mogelijkheden van het platform aandrijft. Als een flow een leverancierspecifieke piece met zijn eigen verbinding gebruikt, routeert dat verkeer niet via jouw gatewayvermelding.

Wie routeert Activepieces via een gateway.

• Self-hostende teams die AI standaardiseren over tientallen flows, waar één providervermelding en één sleutel verspreide credentials per piece vervangen.
• Platformadmins die modelgovernance willen: een gecureerde modellijst, gebruik per sleutel, en de mogelijkheid om het achterliggende endpoint te wisselen zonder flows aan te raken.
• Bureaus die klantautomatiseringen op één instantie draaien, met AI-gebruik per klant gemeten via aparte sleutels op dezelfde catalogus.
• Bouwers wier flows volumestappen en beoordelingsstappen mixen, door snelle ID's te koppelen aan frontier-ID's per stap via één endpoint.
• Developers zonder toegang tot de facturering van een bepaalde leverancier. Toegang op basis van opwaarderen zonder kaartvereiste verwijdert de aanmeldingsafhankelijkheid per provider.

Verifieer het endpoint en debug de eerste AI-stap.

Draai de twee curls hierboven voordat je de provider opslaat; ze bewijzen de sleutel, de Base URL, en het model-ID samen, precies wat het formulier niet voor je zal controleren. Wanneer de AI-stap van een flow faalt na het instellen, lees de stapfout. Authenticatiefouten betekenen dat het sleutelveld of de headernaam verkeerd is (of dat het Bearer-voorvoegsel ontbreekt op een endpoint dat het vereist). Een model-not-found-fout is een geregistreerd ID dat niet overeenkomt met de catalogus. Een verbindingsfout betekent meestal dat de Base URL zijn /v1 kwijt is. Als de stap geen enkel model kan vinden om te selecteren, is de provider opgeslagen maar is de modellijst leeg voor dat modeltype. Zodra flows draaien, toont de APIsRouter-console model per verzoek, tokenaantallen en uitgaven. Geplande automatiseringen tellen stilletjes op, en de gebruiksweergave per sleutel is hoe een platformadmin ziet welke flows hun tokens waard zijn voordat de factuur dat doet.

Veelgestelde vragen