Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Dodaj prilagođene pružatelje usluga

Lekcija 7 od 16 Ažurirano 2. studenoga 2026. Programer
Na ovoj stranici
  1. Zašto koristiti pružatelje usluga trećih strana?
  2. Anatomija pružatelja usluga
  3. Primjeri uobičajenih pružatelja usluga
  4. Deklariranje modela na pružatelju usluga
  5. Potpuni primjer: OpenRouter
  6. Lokalni pružatelj s Ollama-om
  7. Ključne točke

Ažurirano 2. studenoga 2026. — Devstral. Devstral 2 (devstral-2512) dosegnuo je kraj životnog vijeka 31. srpnja 2026., a Devstral Small 2 31. ožujka 2026.: pozivi tim modelima više nisu zajamčeni. Službena tablica preusmjerava ih na Mistral Medium 3.5, koji je sam zastario u korist Mistral Large 4. Codestral (codestral-2508) ostaje općenito dostupan za dovršavanje koda. Provjeri tablicu modela kako bi vidio/la na što vode aliasi -latest prije ponovne uporabe ovih primjera.

Zašto koristiti pružatelje usluga trećih strana?

Zadano, Vibe komunicira s Mistral API-jem. No arhitektura alata dizajnirana je da bude agnostična: možeš dodati bilo kojeg pružatelja usluga kompatibilnog s formatom OpenAI API-ja. Time se rješavaju četiri stvarne potrebe. Možeš pristupiti modelima drugih dobavljača—Claude, GPT, Llama—usmjeravati promet kroz relej poput OpenRouter-a kako bi usporedio/la više modela na istom zadatku, ukazati na lokalnu instancu (Ollama, vLLM) kada kod ne smije napustiti stroj ili mijenjati pružatelje usluga ovisno o prirodi posla.

Tipičan scenarij uključuje tim koji svakodnevno radi s Devstral 2 na Mistral API-ju, ali prelazi na lokalnu instancu uvijek kada obrađuje repozitorij klijenta podložan ograničenjima povjerljivosti.

Anatomija pružatelja usluga

Pružatelja usluga deklariraš u config.toml koristeći direktivu [[providers]]:

[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"

Svako polje ima specifičnu ulogu:

  • name — Jedinstveni identifikator za pružatelja usluga (koristi se za referenciranje modela)
  • api_base — Osnovni URL API-ja (završetak /chat/completions automatski će se dodati)
  • api_key_env_var — Naziv varijable okruženja koja sadrži API ključ
  • api_style — Format API-ja. Koristi "openai" za bilo kojeg pružatelja kompatibilnog s OpenAI-jem
  • backend — Vrsta pozadinskog sustava. "generic" funkcionira u većini slučajeva

Klasična zamka odnosi se na api_base: budući da Vibe sam dodaje /chat/completions, URL koji već uključuje ovaj sufiks rezultirat će nevažećom adresom i mrežnom pogreškom koju je teško dijagnosticirati.

Primjeri uobičajenih pružatelja usluga

Ovdje su vrijednosti koje trebaš unijeti za najraširenije usluge. Dva lokalna pružatelja nemaju varijablu ključa jer ne zahtijevaju autentifikaciju.

Pružateljapi_baseapi_key_env_var
OpenRouterhttps://openrouter.ai/api/v1OPENROUTER_API_KEY
Ollama (lokalno)http://localhost:11434/v1—
Together AIhttps://api.together.xyz/v1TOGETHER_API_KEY
Groqhttps://api.groq.com/openai/v1GROQ_API_KEY
vLLM (samostalno hostiranje)http://votre-serveur:8000/v1—

Deklariranje modela na pružatelju usluga

Deklariranje pružatelja usluga nije dovoljno: zatim moraš pridružiti modele koje namjeravaš koristiti.

[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-openrouter"
temperature = 0.2

Polje name ponavlja identifikator modela točno onako kako ga pružatelj usluga poznaje, znak po znak. provider mora odgovarati name prethodno deklariranog pružatelja usluga, inače Vibe neće znati kamo poslati zahtjev. alias definira kratko ime za korištenje unutar Vibe-a, a temperature postavlja razinu kreativnosti, od 0.0 za determinističko ponašanje do 1.0 za inventivniji model. Za kod, niska vrijednost poput one u primjeru daje mnogo stabilnije rezultate.

Da bi ovaj model omogućio/la kao zadani, jednostavno ponovno upotrijebi njegov alias:

active_model = "devstral-openrouter"

Potpuni primjer: OpenRouter

Evo potpune konfiguracije s jednim pružateljem usluga i dva pridružena modela:

# ~/.vibe/config.toml

# OpenRouter Provider
[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"

# Free Devstral model via OpenRouter
[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-free"
temperature = 0.2

# Llama model via OpenRouter
[[models]]
name = "meta-llama/llama-3.3-70b-instruct"
provider = "openrouter"
alias = "llama-70b"
temperature = 0.3

Sama konfiguracija nije dovoljna: još uvijek moraš definirati varijablu okruženja koju pružatelj usluga očekuje, inače će pozivi odlaziti bez autentifikacije.

export OPENROUTER_API_KEY="sk-or-votre-cle-ici"

Kada su oba modela deklarirana, imaš dva zamjenjiva aliasa. Tijekom sesije, /model devstral-free prebacuje između njih bez gubitka razgovora, što ti omogućuje usporedbu dva odgovora na isti problem. Pri pokretanju, opcija --model čini istu stvar: vibe --model llama-70b.

Lokalni pružatelj s Ollama-om

Slučaj modela koji se poslužuje lokalno zaslužuje zaseban primjer, jer ne zahtijeva API ključ: polje api_key_env_var jednostavno ostaje prazno.

[[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"

Prednost je izravna: tvoji podaci nikada ne napuštaju tvoj stroj. Ovo je opcija koju trebaš odabrati za rad na osjetljivom kodu ili jednostavno za nastavak programiranja u vlaku bez internetske veze.

Ključne točke

  • Vibe podržava bilo kojeg pružatelja usluga kompatibilnog s formatom OpenAI API-ja
  • Deklariraj pružatelja usluga s [[providers]] u config.toml
  • Svaki model je pridružen pružatelju usluga i može imati alias
  • /model ti omogućuje prebacivanje između modela tijekom sesije
  • Lokalni pružatelji (Ollama, vLLM) omogućuju rad izvan mreže