Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Pridanie vlastných poskytovateľov

Lekcia 7 z 16 Aktualizované 2. novembra 2026 Vývojár
Na tejto strane
  1. Prečo používať poskytovateľov tretích strán?
  2. Anatómia poskytovateľa
  3. Príklady bežných poskytovateľov
  4. Deklarovanie modelu u poskytovateľa
  5. Kompletný príklad: OpenRouter
  6. Lokálny poskytovateľ s Ollama
  7. Kľúčové poznatky

Aktualizované 2. novembra 2026 — Devstral. Devstral 2 (devstral-2512) dosiahol koniec životnosti 31. júla 2026 a Devstral Small 2 31. marca 2026: volania týchto modelov už nie sú garantované. Oficiálna tabuľka ich presmerováva na Mistral Medium 3.5, ktorý je sám o sebe zastaraný v prospech Mistral Large 4. Codestral (codestral-2508) zostáva všeobecne dostupný na dokončovanie kódu. Pred opätovným použitím týchto príkladov si v tabuľke modelov over, kam smerujú aliasy -latest.

Prečo používať poskytovateľov tretích strán?

V predvolenom nastavení komunikuje Vibe s API služby Mistral. Architektúra nástroja je však navrhnutá ako agnostická: môžete pridať akéhokoľvek poskytovateľa kompatibilného s formátom API OpenAI. Tým riešite štyri reálne potreby. Môžete získať prístup k modelom od iných dodávateľov – Claude, GPT, Llama –, smerovať požiadavky cez relay ako OpenRouter na porovnanie viacerých modelov pri rovnakej úlohe, pripojiť sa k lokálnej inštancii (Ollama, vLLM), keď kód nesmie opustiť stroj, alebo meniť poskytovateľov podľa povahy práce.

Typickým scenárom je tím, ktorý denne pracuje s Devstral 2 cez API Mistral, ale pri práci s klientskym repozitárom podliehajúcim obmedzeniam dôvernosti prepne na lokálnu inštanciu.

Anatómia poskytovateľa

Poskytovateľa deklarujete v súbore config.toml pomocou direktívy [[providers]]:

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

Každé pole má špecifickú úlohu:

  • name – Jedinečný identifikátor poskytovateľa (používa sa na odkazovanie na modely)
  • api_base – Základná URL adresa API (koncový bod /chat/completions sa automaticky pripojí)
  • api_key_env_var – Názov premennej prostredia obsahujúcej API kľúč
  • api_style – Formát API. Pre akéhokoľvek poskytovateľa kompatibilného s OpenAI použite "openai"
  • backend – Typ backendu. "generic" funguje vo väčšine prípadov

Klasickou pascou je api_base: keďže Vibe si sám pripája /chat/completions, URL adresa, ktorá už tento suffix obsahuje, výsledkom bude neplatná adresa a ťažko diagnostikovateľná chyba siete.

Príklady bežných poskytovateľov

Tu sú hodnoty, ktoré treba zadať pre najrozšírenejšie služby. Dva lokálni poskytovatelia nemajú premennú kľúča, keďže nevyžadujú autentifikáciu.

Poskytovateľapi_baseapi_key_env_var
OpenRouterhttps://openrouter.ai/api/v1OPENROUTER_API_KEY
Ollama (lokálne)http://localhost:11434/v1—
Together AIhttps://api.together.xyz/v1TOGETHER_API_KEY
Groqhttps://api.groq.com/openai/v1GROQ_API_KEY
vLLM (self-hosted)http://votre-serveur:8000/v1—

Deklarovanie modelu u poskytovateľa

Samotná deklarácia poskytovateľa nestačí: musíte následne pripojiť modely, ktoré intendujete používať.

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

Pole name opakuje identifikátor modelu presne tak, ako ho pozná poskytovateľ, znak po znaku. provider sa musí zhodovať s name poskytovateľa deklarovaného skôr, inak Vibe nebude vedieť, kam odoslať požiadavku. alias definuje skrátený názov na použitie vo vnútri Vibe a temperature nastavuje mieru kreativity, od 0,0 pre deterministické správanie až po 1,0 pre invenčnejší model. Pri práci s kódom prináša nízka hodnota, ako je tá v príklade, oveľa stabilnejšie výsledky.

Ak chcete tento model povoliť ako predvolený, jednoducho znovu použite jeho alias:

active_model = "devstral-openrouter"

Kompletný príklad: OpenRouter

Tu je kompletná konfigurácia s jedným poskytovateľom a dvoma pripojenými modelmi:

# ~/.vibe/config.toml

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

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

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

Samotná konfigurácia nestačí: stále musíte definovať premennú prostredia, ktorú poskytovateľ očakáva, inak budú volania odoslané bez autentifikácie.

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

Akonáhle sú oba modely deklarované, máte k dispozícii dva zameniteľné aliasy. Počas relácie vám príkaz /model devstral-free umožní prepínať medzi nimi bez straty konverzácie, čo vám umožňuje porovnať dve odpovede na rovnaký problém. Pri spustení robí to isté možnosť --model: vibe --model llama-70b.

Lokálny poskytovateľ s Ollama

Prípad modelu obsluhovaného lokálne si zaslúži samostatný príklad, keďže nevyžaduje API kľúč: pole api_key_env_var jednoducho zostane prázdne.

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

Výhoda je priama: vaše dáta nikdy neopustia váš stroj. Toto je voľba pre prácu s citlivým kódom alebo jednoducho pre kódovanie vo vlaku bez internetového pripojenia.

Kľúčové poznatky

  • Vibe podporuje akéhokoľvek poskytovateľa kompatibilného s formátom API OpenAI
  • Poskytovateľa deklarujete pomocou [[providers]] v súbore config.toml
  • Každý model je pripojený k poskytovateľovi a môže mať alias
  • /model vám umožňuje prepínať medzi modelmi počas relácie
  • Lokálni poskytovatelia (Ollama, vLLM) umožňujú prácu offline