Documentazione

Collegare una chiave LLM

Modelli gestiti fatturati in crediti, oppure BYOK — collega OpenAI, Anthropic, Google Gemini o un modello privato (Ollama, LM Studio, compatibile OpenAI).

betool ti lascia scegliere, modello per modello, tra due modi di accedere a un LLM:

  • Modelli gestiti — l'operatore della piattaforma mette a disposizione degli account LLM condivisi. Li usi senza collegare alcuna chiave; il consumo viene addebitato in crediti, secondo una tariffa per token in ingresso e in uscita. Nessun modello è gratuito.
  • BYOK (Bring Your Own Key) — fornisci le tue chiavi API (o l'URL del tuo modello privato). I costi di inferenza vengono fatturati direttamente dal tuo provider; betool non trattiene nulla sui token.

Negli ambienti regolamentati, il BYOK è l'opzione raccomandata: il tuo contratto (DPA) con il provider resta l'unica catena contrattuale, la tua fatturazione è leggibile voce per voce e revochi la chiave senza passare da noi. Vedi BYOK — perché è irrinunciabile nei settori regolamentati.

Provider supportati

ProviderModelliModalità
OpenAIGenerazione GPT attualeAPI pubblica
AnthropicClaude (Opus, Sonnet, Haiku)API pubblica
GoogleGeminiAPI pubblica
OllamaModelli open-weight, modelli personalizzatiSelf-hosted, oppure Ollama Cloud
LM StudioModelli localiSelf-hosted
Endpoint compatibile OpenAIvLLM e altri server che espongono l'API OpenAISelf-hosted (URL personalizzato)

Il catalogo dei modelli gestiti segue la generazione attuale di Claude, GPT e Gemini, oltre a modelli open-weight serviti da Ollama Cloud (Kimi, GLM…). L'elenco esatto e aggiornato è visibile nel selettore di modello dell'admin.

Passo 1 — Recupera la tua chiave API

Segui la procedura del tuo provider:

Passo 2 — Registra la chiave in betool

  1. Nell'admin, apri Impostazioni → Provider.
  2. Clicca su + Aggiungi un account.
  3. Seleziona il provider, incolla la chiave API (e l'URL per un modello self-hosted).
  4. Assegna un nome leggibile (ad es. « OpenAI - prod »).

La chiave non viene mai restituita dall'API una volta salvata. Se hai bisogno di rigenerarla, dovrai aggiornarla manualmente. Le route GET restituiscono solo has_api_key: true | false.

Passo 3 — Scegli i tuoi modelli

Ogni nodo agente delle tue pipeline fa poi riferimento all'account e al modello da utilizzare — lo stesso account può servire più modelli.

Ad esempio, un account OpenAI può servire un modello di fascia alta per gli agenti principali e un modello più leggero per la classificazione veloce.

Account condivisi

Gli account LLM condivisi (flag is_shared) sono quelli che portano i modelli gestiti. Sono visibili alle organizzazioni senza collegare alcuna chiave, e la risoluzione privilegia sempre i tuoi account (own > shared).

Prezzi

Consulta Prezzi per i dettagli sul metering. Promemoria: in modalità BYOK, non addebitiamo i token LLM — solo la nostra orchestrazione. Su un modello gestito, i token vengono addebitati in crediti.

Passo successivo

Panoramica dei canali di ingresso →