Přidání vlastních poskytovatelů
Na této stránce
Aktualizováno 2. listopadu 2026 — Devstral. Devstral 2 (
devstral-2512) dosáhl konce životnosti 31. července 2026 a Devstral Small 2 31. března 2026: volání těchto modelů již nejsou garantována. Oficiální tabulka je přesměrovává na Mistral Medium 3.5, který je sám o sobě zastaralý ve prospěch Mistral Large 4. Codestral (codestral-2508) zůstává obecně dostupný pro doplňování kódu. Před opětovným použitím těchto příkladů si v tabulce modelů ověř, kam směřují aliasy-latest.
Proč používat poskytovatele třetích stran?
Ve výchozím nastavení komunikuje Vibe s API Mistral. Architektura nástroje je však navržena jako agnostická: můžete přidat jakéhokoli poskytovatele kompatibilního s formátem OpenAI API. Tím řešíte čtyři reálné potřeby. Můžete získat přístup k modelům od jiných dodavatelů – Claude, GPT, Llama –, směrovat požadavky přes relay službu jako OpenRouter pro porovnání více modelů na stejném úkolu, připojit se k lokální instanci (Ollama, vLLM), pokud kód nesmí opustit stroj, nebo měnit poskytovatele podle povahy práce.
Typickým scénářem je tým, který denně pracuje s Devstral 2 přes API Mistral, ale při práci s klientským repozitářem podléhajícím důvěrnosti přepne na lokální instanci.
Anatomie poskytovatele
Poskytovatele deklarujete v souboru config.toml pomocí direktivy [[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á specifickou roli:
- name – Jedinečný identifikátor poskytovatele (používá se pro odkazování na modely)
- api_base – Základní URL API (koncový bod
/chat/completionsse automaticky připojí) - api_key_env_var – Název proměnné prostředí obsahující API klíč
- api_style – Formát API. Pro jakéhokoli poskytovatele kompatibilního s OpenAI použijte
"openai" - backend – Typ backendu.
"generic"funguje ve většině případů
Klasickou pastí je api_base: protože Vibe sám připojuje /chat/completions, URL, která již tuto příponu obsahuje, povede na neplatnou adresu a způsobí síťovou chybu, kterou se těžko diagnostikuje.
Příklady běžných poskytovatelů
Zde jsou hodnoty pro nejrozšířenější služby. Dva lokální poskytovatelé nemají proměnnou pro klíč, protože nevyžadují ověření.
| Poskytovatel | api_base | api_key_env_var |
|---|---|---|
| OpenRouter | https://openrouter.ai/api/v1 | OPENROUTER_API_KEY |
| Ollama (lokální) | 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 | — |
Deklarace modelu u poskytovatele
Samotná deklarace poskytovatele nestačí: musíte k němu připojit modely, které hodláte používat.
[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-openrouter"
temperature = 0.2
Pole name opakuje identifikátor modelu přesně tak, jak ho zná poskytovatel, znak po znaku. provider se musí shodovat s name dříve deklarovaného poskytovatele, jinak Vibe nebude vědět, kam požadavek odeslat. alias definuje zkrácený název pro použití ve Vibe a temperature nastavuje míru kreativity od 0,0 pro deterministické chování až po 1,0 pro invenčnější model. Pro kód nízká hodnota, jako v příkladu, přináší mnohem stabilnější výsledky.
Chcete-li tento model povolit jako výchozí, jednoduše znovu použijte jeho alias:
active_model = "devstral-openrouter"
Kompletní příklad: OpenRouter
Zde je kompletní konfigurace s jedním poskytovatelem a dvěma připojenými modely:
# ~/.vibe/config.toml
# Poskytovatel 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 přes OpenRouter
[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-free"
temperature = 0.2
# Model Llama přes OpenRouter
[[models]]
name = "meta-llama/llama-3.3-70b-instruct"
provider = "openrouter"
alias = "llama-70b"
temperature = 0.3
Samotná konfigurace nestačí: musíte ještě definovat proměnnou prostředí, kterou poskytovatel očekává, jinak budou volání odcházet bez ověření.
export OPENROUTER_API_KEY="sk-or-votre-cle-ici"
Jakmile jsou oba modely deklarovány, máte k dispozici dva zaměnitelné aliasy. Během relace příkaz /model devstral-free mezi nimi přepíná bez ztráty konverzace, což vám umožňuje porovnat dvě odpovědi na stejný problém. Při spuštění dělá totéž možnost --model: vibe --model llama-70b.
Lokální poskytovatel s Ollama
Případ modelu běžícího lokálně si zaslouží samostatný příklad, protože nevyžaduje API klíč: pole api_key_env_var jednoduše zůstane prázdné.
[[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 přímá: vaše data nikdy neopustí váš stroj. Toto je volba pro práci s citlivým kódem nebo jednoduše pro kódování ve vlaku bez připojení k internetu.
Klíčové poznatky
- Vibe podporuje jakéhokoli poskytovatele kompatibilního s formátem OpenAI API
- Poskytovatele deklarujete pomocí
[[providers]]v souboru config.toml - Každý model je připojen k poskytovateli a může mít alias
/modelvám umožňuje přepínat mezi modely během relace- Lokální poskytovatelé (Ollama, vLLM) umožňují práci offline