Aggiungere provider personalizzati
In questa pagina
Aggiornato il 2 novembre 2026 — Devstral. Devstral 2 (
devstral-2512) ha raggiunto la fine del supporto il 31 luglio 2026 e Devstral Small 2 il 31 marzo 2026: le chiamate a questi modelli non sono più garantite. La tabella ufficiale li reindirizza a Mistral Medium 3.5, che è a sua volta deprecato a favore di Mistral Large 4. Codestral (codestral-2508) rimane generalmente disponibile per il completamento del codice. Controlla la tabella dei modelli per vedere dove puntano gli alias-latestprima di riutilizzare questi esempi.
Perché usare provider di terze parti?
Per impostazione predefinita, Vibe comunica con le API di Mistral. Tuttavia, l’architettura dello strumento è progettata per essere agnostica: puoi aggiungere qualsiasi provider compatibile con il formato delle API OpenAI. Questo risponde a quattro esigenze concrete. Puoi accedere a modelli di altri fornitori (Claude, GPT, Llama), instradare le richieste attraverso un relay come OpenRouter per confrontare più modelli sullo stesso compito, puntare a un’istanza locale (Ollama, vLLM) quando il codice non deve lasciare la macchina, oppure cambiare provider in base alla natura del lavoro.
Uno scenario tipico coinvolge un team che lavora quotidianamente con Devstral 2 sulle API di Mistral, ma passa a un’istanza locale ogni volta che gestisce un repository cliente soggetto a vincoli di riservatezza.
Anatomia di un provider
Dichiari un provider in config.toml usando la direttiva [[providers]]:
[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"
Ogni campo ha un ruolo specifico:
- name — Identificativo univoco del provider (usato per riferirsi ai modelli)
- api_base — URL base dell’API (l’endpoint
/chat/completionsverrà aggiunto automaticamente) - api_key_env_var — Nome della variabile d’ambiente contenente la chiave API
- api_style — Formato dell’API. Usa
"openai"per qualsiasi provider compatibile con OpenAI - backend — Tipo di backend.
"generic"funziona nella maggior parte dei casi
L’errore classico riguarda api_base: poiché Vibe aggiunge da solo /chat/completions, un URL che include già questo suffisso risulterà in un indirizzo non valido e in un errore di rete difficile da diagnosticare.
Esempi di provider comuni
Ecco i valori da inserire per i servizi più diffusi. I due provider locali non hanno variabili per la chiave, poiché non richiedono autenticazione.
| Provider | api_base | api_key_env_var |
|---|---|---|
| OpenRouter | https://openrouter.ai/api/v1 | OPENROUTER_API_KEY |
| Ollama (locale) | http://localhost:11434/v1 | — |
| Together AI | https://api.together.xyz/v1 | TOGETHER_API_KEY |
| Groq | https://api.groq.com/openai/v1 | GROQ_API_KEY |
| vLLM (self-hosted) | http://votre-serveur:8000/v1 | — |
Dichiarare un modello su un provider
Dichiarare il provider non basta: devi poi collegare i modelli che intendi utilizzare.
[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-openrouter"
temperature = 0.2
Il campo name ripete l’identificativo del modello esattamente come lo conosce il provider, carattere per carattere. provider deve corrispondere al name di un provider dichiarato in precedenza, altrimenti Vibe non saprà dove inviare la richiesta. alias definisce un nome abbreviato da usare all’interno di Vibe, mentre temperature imposta la creatività, da 0.0 per un comportamento deterministico a 1.0 per un modello più inventivo. Per il codice, un valore basso come quello nell’esempio produce risultati molto più stabili.
Per abilitare questo modello come predefinito, basta riutilizzare il suo alias:
active_model = "devstral-openrouter"
Esempio completo: OpenRouter
Ecco una configurazione completa con un provider e due modelli collegati:
# ~/.vibe/config.toml
# Provider OpenRouter
[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"
# Modello Devstral gratuito tramite OpenRouter
[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-free"
temperature = 0.2
# Modello Llama tramite OpenRouter
[[models]]
name = "meta-llama/llama-3.3-70b-instruct"
provider = "openrouter"
alias = "llama-70b"
temperature = 0.3
La sola configurazione non basta: devi ancora definire la variabile d’ambiente che il provider si aspetta, altrimenti le chiamate partiranno senza autenticazione.
export OPENROUTER_API_KEY="sk-or-votre-cle-ici"
Una volta dichiarati entrambi i modelli, hai due alias intercambiabili. Durante una sessione, /model devstral-free permette di passare dall’uno all’altro senza perdere la conversazione, consentendoti di confrontare due risposte sullo stesso problema. All’avvio, l’opzione --model fa la stessa cosa: vibe --model llama-70b.
Provider locale con Ollama
Il caso di un modello servito localmente merita un esempio a parte, poiché non richiede alcuna chiave API: il campo api_key_env_var rimane semplicemente vuoto.
[[providers]]
name = "ollama"
api_base = "http://localhost:11434/v1"
api_key_env_var = ""
api_style = "openai"
backend = "generic"
[[models]]
name = "codestral:latest"
provider = "ollama"
alias = "codestral-local"
Il vantaggio è immediato: i tuoi dati non lasciano mai la tua macchina. Questa è l’opzione da scegliere per lavorare su codice sensibile, o semplicemente per continuare a programmare su un treno senza connessione internet.
Punti chiave
- Vibe supporta qualsiasi provider compatibile con il formato delle API OpenAI
- Dichiara un provider con
[[providers]]in config.toml - Ogni modello è collegato a un provider e può avere un alias
/modelti permette di cambiare modello durante una sessione- I provider locali (Ollama, vLLM) abilitano il lavoro offline