Adăugarea de furnizori personalizați
Pe această pagină
Actualizat pe 2 noiembrie 2026 — Devstral. Devstral 2 (
devstral-2512) și-a atins sfârșitul ciclului de viață la 31 iulie 2026, iar Devstral Small 2 la 31 martie 2026: apelurile către aceste modele nu mai sunt garantate. Tabelul oficial le redirecționează către Mistral Medium 3.5, care este la rândul său depreciat în favoarea Mistral Large 4. Codestral (codestral-2508) rămâne disponibil pentru completarea codului. Verificați tabelul de modele pentru a vedea unde indică aliasurile-latestînainte de a reutiliza aceste exemple.
De ce să utilizați furnizori terți?
În mod implicit, Vibe comunică cu API-ul Mistral. Cu toate acestea, arhitectura instrumentului este concepută să fie agnostică: puteți adăuga orice furnizor compatibil cu formatul API OpenAI. Acest lucru răspunde la patru nevoi concrete. Puteți accesa modele de la alți vânzători—Claude, GPT, Llama—să rutați traficul printr-un releu precum OpenRouter pentru a compara mai multe modele asupra aceleiași sarcini, să vă conectați la o instanță locală (Ollama, vLLM) atunci când codul nu trebuie să părăsească mașina sau să schimbați furnizorii în funcție de natura lucrului.
Un scenariu tipic implică o echipă care lucrează zilnic cu Devstral 2 prin API-ul Mistral, dar care comută pe o instanță locală ori de câte ori gestionează un depozit de cod al unui client supus unor constrângeri de confidențialitate.
Anatomia unui furnizor
Declarați un furnizor în config.toml folosind directiva [[providers]]:
[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"
Fiecare câmp are un rol specific:
- name — Identificator unic pentru furnizor (folosit pentru a face referire la modele)
- api_base — URL-ul de bază al API-ului (endpoint-ul
/chat/completionsva fi adăugat automat) - api_key_env_var — Numele variabilei de mediu care conține cheia API
- api_style — Formatul API. Utilizați
"openai"pentru orice furnizor compatibil cu OpenAI - backend — Tipul de backend.
"generic"funcționează în majoritatea cazurilor
Capcana clasică ține de api_base: deoarece Vibe adaugă singur /chat/completions, un URL care include deja acest sufix va rezulta într-o adresă invalidă și într-o eroare de rețea dificil de diagnosticat.
Exemple de furnizori comuni
Iată valorile de introdus pentru cele mai răspândite servicii. Cei doi furnizori locali nu au o variabilă de cheie, deoarece nu necesită autentificare.
| Furnizor | api_base | api_key_env_var |
|---|---|---|
| OpenRouter | https://openrouter.ai/api/v1 | OPENROUTER_API_KEY |
| Ollama (local) | 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 (găzduit propriu) | http://votre-serveur:8000/v1 | — |
Declararea unui model pe un furnizor
Declararea furnizorului nu este suficientă: trebuie apoi să atașați modelele pe care intenționați să le utilizați.
[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-openrouter"
temperature = 0.2
Câmpul name repetă identificatorul modelului exact așa cum îl cunoaște furnizorul, caracter cu caracter. provider trebuie să corespundă cu name al unui furnizor declarat anterior, altfel Vibe nu va ști unde să trimită cererea. alias definește un nume scurt de utilizat în cadrul Vibe, iar temperature stabilește creativitatea, de la 0.0 pentru un comportament determinist la 1.0 pentru un model mai inventiv. Pentru cod, o valoare scăzută, precum cea din exemplu, oferă rezultate mult mai stabile.
Pentru a activa acest model în mod implicit, reutilizați pur și simplu aliasul său:
active_model = "devstral-openrouter"
Exemplu complet: OpenRouter
Iată o configurație completă cu un furnizor și două modele atașate:
# ~/.vibe/config.toml
# Furnizor OpenRouter
[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"
# Model Devstral gratuit prin OpenRouter
[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-free"
temperature = 0.2
# Model Llama prin OpenRouter
[[models]]
name = "meta-llama/llama-3.3-70b-instruct"
provider = "openrouter"
alias = "llama-70b"
temperature = 0.3
Configurația singură nu este suficientă: trebuie totuși să definiți variabila de mediu pe care o așteaptă furnizorul, altfel apelurile vor pleca fără autentificare.
export OPENROUTER_API_KEY="sk-or-votre-cle-ici"
Odată ce ambele modele sunt declarate, aveți la dispoziție două aliasuri interschimbabile. În timpul unei sesiuni, /model devstral-free comută între ele fără a pierde conversația, permițându-vă să comparați două răspunsuri la aceeași problemă. La lansare, opțiunea --model face același lucru: vibe --model llama-70b.
Furnizor local cu Ollama
Cazul unui model servit local merită un exemplu separat, deoarece nu necesită nicio cheie API: câmpul api_key_env_var rămâne pur și simplu gol.
[[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"
Avantajul este direct: datele dumneavoastră nu părăsesc niciodată mașina. Aceasta este opțiunea de ales pentru lucrul la cod sensibil sau pur și simplu pentru a continua programarea într-un tren fără conexiune la internet.
Puncte cheie
- Vibe suportă orice furnizor compatibil cu formatul API OpenAI
- Declarați un furnizor cu
[[providers]]în config.toml - Fiecare model este atașat unui furnizor și poate avea un alias
/modelvă permite să comutați între modele în timpul unei sesiuni- Furnizorii locali (Ollama, vLLM) permit lucrul offline