Pridanie vlastných poskytovateľov
Na tejto strane
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/completionssa 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_base | api_key_env_var |
|---|---|---|
| OpenRouter | https://openrouter.ai/api/v1 | OPENROUTER_API_KEY |
| Ollama (lokálne) | 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 | — |
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
/modelvám umožňuje prepínať medzi modelmi počas relácie- Lokálni poskytovatelia (Ollama, vLLM) umožňujú prácu offline