Salt la conținutul principal
Română— Alege o limbă
Meniu

Adăugarea de furnizori personalizați

Lecția 7 din 16 Actualizată 2 noiembrie 2026 Dezvoltator
Pe această pagină
  1. De ce să utilizați furnizori terți?
  2. Anatomia unui furnizor
  3. Exemple de furnizori comuni
  4. Declararea unui model pe un furnizor
  5. Exemplu complet: OpenRouter
  6. Furnizor local cu Ollama
  7. Puncte cheie

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/completions va 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.

Furnizorapi_baseapi_key_env_var
OpenRouterhttps://openrouter.ai/api/v1OPENROUTER_API_KEY
Ollama (local)http://localhost:11434/v1—
Together AIhttps://api.together.xyz/v1TOGETHER_API_KEY
Groqhttps://api.groq.com/openai/v1GROQ_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
  • /model vă permite să comutați între modele în timpul unei sesiuni
  • Furnizorii locali (Ollama, vLLM) permit lucrul offline