Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Přidání vlastních poskytovatelů

Lekce 7 z 16 Aktualizováno 2. listopadu 2026 Vývojář
Na této stránce
  1. Proč používat poskytovatele třetích stran?
  2. Anatomie poskytovatele
  3. Příklady běžných poskytovatelů
  4. Deklarace modelu u poskytovatele
  5. Kompletní příklad: OpenRouter
  6. Lokální poskytovatel s Ollama
  7. Klíčové poznatky

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/completions se 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í.

Poskytovatelapi_baseapi_key_env_var
OpenRouterhttps://openrouter.ai/api/v1OPENROUTER_API_KEY
Ollama (lokální)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—

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
  • /model vám umožňuje přepínat mezi modely během relace
  • Lokální poskytovatelé (Ollama, vLLM) umožňují práci offline