Dai ai flussi di Activepieces un provider AI OpenAI-compatible.

Risposta rapida: una voce provider nella configurazione AI di amministrazione.

Nella console di amministrazione di Activepieces, apri la pagina di configurazione AI e aggiungi un provider di tipo OpenAI Compatible. Il modulo richiede un Display Name, una API Key, una Base URL, un API Key Header, header predefiniti opzionali, e un elenco modelli dove ogni voce ha un Model ID, un Model Name e un Model Type. I valori per APIsRouter: la Base URL è https://api.apisrouter.com/v1 (la stessa forma che il codebase usa per i propri provider compatibili integrati), l'API Key Header è Authorization, e il campo chiave prende la tua chiave gateway. Un dettaglio implementativo utile da sapere: Activepieces invia la chiave in quell'header esattamente come l'hai digitata, senza aggiungere automaticamente il prefisso Bearer, quindi inseriscila come "Bearer sk-..." per la forma canonica; APIsRouter accetta anche la chiave nuda nell'header Authorization, quindi entrambe le forme funzionano qui. Poi aggiungi ogni modello che vuoi che i flow vedano, con il Model ID che corrisponde esattamente al catalogo.

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

Come Activepieces usa un provider personalizzato.

Activepieces (circa 23K stelle su GitHub) è la piattaforma di automazione no-code open source leader: flow costruiti da trigger e piece, nella forma di Zapier ma self-hostabile, con un framework di piece con licenza MIT e un ampio catalogo della community. Le sue capacità AI (step di generazione testo, agenti, piece di utilità AI) risolvono il proprio modello attraverso i provider AI configurati dalla piattaforma, ed è per questo che la voce provider è una decisione di routing per ogni flow in una volta sola. Sotto il cofano, il provider OpenAI Compatible costruisce un client standard verso la tua Base URL e allega la tua chiave sotto il nome di header che hai scelto, più header di metadata per esecuzione che identificano progetto e flow. Il Model ID che hai registrato viene passato come stringa model nelle richieste chat-completions. Non c'è auto-discovery dei modelli per questo tipo di provider: i flow possono selezionare esattamente i modelli che hai aggiunto all'elenco, il che mantiene il selettore intenzionale invece che sommerso. La configurazione del provider è a livello di piattaforma. Un amministratore la definisce una volta, e ogni progetto e flow sull'istanza sceglie tra i modelli registrati. Questa centralizzazione è il vantaggio di governance: un solo posto per decidere quali modelli esistono, una sola chiave per misurare tutti gli step AI, e i metadata per flow in ogni richiesta che rendono l'utilizzo attribuibile quando leggi i log.

Configurazione completa e l'avvertenza al momento del salvataggio.

Il modulo si salva senza validare la connessione; l'implementazione del provider salta esplicitamente i controlli di connessione per il tipo OpenAI Compatible. Questo è comodo (nessuna verifica del tuo endpoint al momento del salvataggio) ma significa che una Base URL sbagliata o una chiave malformata falliscono più tardi, alla prima esecuzione di flow che tocca uno step AI. Verifica l'endpoint a mano una volta prima di collegarlo a flow di produzione, e considera la prima esecuzione come parte della configurazione. Il Model Type conta per determinare quali piece possono usare la voce: gli step di testo vogliono modelli TEXT. Registra l'id esattamente come lo scrive il catalogo; il Model Name è un'etichetta di visualizzazione e può essere qualsiasi cosa leggibile. Se vuoi lo stesso modello sottostante a due livelli di prezzo-prestazioni per team diversi, registralo una volta per Model ID; i nomi di visualizzazione li mantengono distinguibili nel selettore.

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

Scegliere i modelli per gli step di automazione.

Poiché il provider è a livello di piattaforma, la governance dei modelli è un'unica schermata: aggiungi gli id che approvi, osserva una settimana di utilizzo per chiave, e rimuovi ciò che nessuno dovrebbe usare. I flow builder mantengono la loro libertà all'interno dell'elenco che hai curato.

• L'AI di automazione è lavoro ad alto volume e prompt brevi: classificare un ticket, estrarre campi, redigere un messaggio, riassumere un payload webhook. claude-haiku-4-5-20251001, gpt-5.4-mini e deepseek-v4-flash coprono la maggior parte degli step a prezzi da volume.
• Riserva un id più forte per gli step che richiedono giudizio. Un flow che redige risposte rivolte ai clienti o prende decisioni di routing merita claude-sonnet-4-6, selezionato per step nel flow builder.
• MiniMax-M2.7 e la famiglia DeepSeek hanno un prezzo eccellente per i flow di trasformazione massiva (feed, pulizia di dati scraped, arricchimento) dove migliaia di esecuzioni al giorno sono normali.
• I flow girano senza supervisione, quindi il costo è una pianificazione moltiplicata per un conteggio token per esecuzione. Il log di utilizzo ti dà il numero per esecuzione; la pianificazione è tua.
• Registra pochi modelli in modo deliberato. Il selettore mostra esattamente ciò che hai aggiunto, e un elenco curato evita che cento flow builder scelgano ciascuno diversamente.

Pagamento a consumo · sotto i prezzi ufficiali

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

Modalità di errore specifiche di Activepieces.

Salvataggio silenzioso, prima esecuzione rumorosa. Poiché il provider OpenAI Compatible salta la validazione della connessione, ogni errore di collegamento (Base URL sbagliata, /v1 mancante, chiave errata, nome header sbagliato) emerge come uno step AI fallito in un'esecuzione di flow invece che come errore del modulo. Quando uno step AI fallisce subito dopo modifiche al provider, sospetta prima la voce provider, poi il flow. La questione del prefisso Bearer. La chiave viene inviata testualmente sotto l'header scelto. Gli endpoint che richiedono il prefisso letterale Bearer lo vogliono digitato nel campo chiave; APIsRouter accetta entrambe le forme, ma se mai ripunti questo provider altrove, ricorda che la piattaforma non aggiungerà il prefisso al posto tuo. I Model ID sono esatti. Un id registrato con un errore di battitura passa il modulo (le etichette sono testo libero) e fallisce in fase di esecuzione con model-not-found; l'output di /v1/models del gateway è la grafia autorevole. L'assenza di auto-discovery è una funzionalità, non un bug. Se un modello manca dal selettore di un flow, non è stato registrato sul provider; aggiungilo nella console di amministrazione invece di cercarlo nel flow builder. E tieni distinte mentalmente le connessioni a livello di piece: singole piece come la piece OpenAI possono avere le proprie credenziali per connessione, mentre la voce provider descritta qui alimenta le capacità AI universali della piattaforma. Se un flow usa una piece specifica di un vendor con la propria connessione, quel traffico non passa attraverso la tua voce gateway.

Chi instrada Activepieces tramite un gateway.

• Team self-hosting che standardizzano l'AI su decine di flow, dove una voce provider e una chiave sostituiscono credenziali sparse per piece.
• Amministratori di piattaforma che vogliono la governance dei modelli: un elenco modelli curato, utilizzo per chiave, e la capacità di cambiare l'endpoint sottostante senza toccare i flow.
• Agenzie che gestiscono automazioni per clienti su un'unica istanza, misurando l'utilizzo AI per cliente con chiavi separate sullo stesso catalogo.
• Builder i cui flow mescolano step di volume e step di giudizio, abbinando id veloci a id di frontiera per step attraverso un unico endpoint.
• Sviluppatori senza accesso alla fatturazione di un dato fornitore. L'accesso basato su ricarica senza obbligo di carta rimuove la dipendenza dalla registrazione per provider.

Verifica l'endpoint e fai debug del primo step AI.

Esegui le due curl sopra prima di salvare il provider; provano insieme la chiave, la Base URL e l'id modello, esattamente ciò che il modulo non controllerà per te. Quando lo step AI di un flow fallisce dopo la configurazione, leggi l'errore dello step. I fallimenti di autenticazione significano che il campo chiave o il nome header è sbagliato (o manca il prefisso Bearer su un endpoint che lo richiede). Un errore model-not-found è un id registrato che non corrisponde al catalogo. Un errore di connessione di solito significa che la Base URL ha perso il suo /v1. Se lo step non trova nessun modello da selezionare, il provider si è salvato ma l'elenco modelli è vuoto per quel Model Type. Una volta che i flow girano, la console di APIsRouter mostra il modello per richiesta, i conteggi dei token e la spesa. Le automazioni pianificate si accumulano silenziosamente, e la vista di utilizzo per chiave è come un amministratore di piattaforma vede quali flow meritano i loro token prima che lo faccia la fattura.

Domande frequenti