Aangepaste providers toevoegen
Op deze pagina
Bijgewerkt op 2 november 2026 — Devstral. Devstral 2 (
devstral-2512) heeft op 31 juli 2026 het einde van zijn levenscyclus bereikt, en Devstral Small 2 op 31 maart 2026: oproepen naar deze modellen zijn niet langer gegarandeerd. De officiële tabel leidt ze door naar Mistral Medium 3.5, dat zelf verouderd is ten gunste van Mistral Large 4. Codestral (codestral-2508) blijft algemeen beschikbaar voor code-aanvulling. Raadpleeg de modellentabel om te zien waar de-latest-aliassen naartoe wijzen voordat u deze voorbeelden hergebruikt.
Waarom third-party providers gebruiken?
Standaard communiceert Vibe met de Mistral API. De architectuur van de tool is echter ontworpen om agnostisch te zijn: u kunt elke provider toevoegen die compatibel is met het OpenAI API-formaat. Dit speelt in op vier reële behoeften. U krijgt toegang tot modellen van andere leveranciers—Claude, GPT, Llama—routeert via een relay zoals OpenRouter om meerdere modellen op dezelfde taak te vergelijken, wijst naar een lokale instantie (Ollama, vLLM) wanneer code de machine niet mag verlaten, of wisselt van provider op basis van de aard van het werk.
Een typisch scenario betreft een team dat dagelijks werkt met Devstral 2 op de Mistral API, maar overschakelt naar een lokale instantie zodra er gewerkt wordt aan een clientrepository die onder geheimhoudingsplicht valt.
Anatomie van een provider
U declareert een provider in config.toml met behulp van de [[providers]]-directive:
[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"
Elk veld heeft een specifieke rol:
- name — Unieke identificatie voor de provider (gebruikt om naar modellen te verwijzen)
- api_base — Basis-URL van de API (het
/chat/completions-endpoint wordt automatisch toegevoegd) - api_key_env_var — Naam van de omgevingsvariabele die de API-sleutel bevat
- api_style — API-formaat. Gebruik
"openai"voor elke OpenAI-compatibele provider - backend — Backend-type.
"generic"werkt voor de meeste gevallen
De klassieke valkuil betreft api_base: omdat Vibe zelf /chat/completions toevoegt, resulteert een URL die dit achtervoegsel al bevat in een ongeldig adres en een moeilijk te diagnosticeren netwerkwfout.
Voorbeelden van veelvoorkomende providers
Hieronder vindt u de waarden die u moet invoeren voor de meest verbreide diensten. De twee lokale providers hebben geen sleutelvariabele, aangezien ze geen authenticatie vereisen.
| Provider | api_base | api_key_env_var |
|---|---|---|
| OpenRouter | https://openrouter.ai/api/v1 | OPENROUTER_API_KEY |
| Ollama (lokaal) | 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 | — |
Een model op een provider declareren
Het declareren van de provider is niet genoeg: u moet vervolgens de modellen koppelen die u intends te gebruiken.
[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-openrouter"
temperature = 0.2
Het veld name herhaalt de modelidentificatie exact zoals de provider deze kent, karakter voor karakter. provider moet overeenkomen met de name van een eerder gedeclareerde provider, anders weet Vibe niet waar het verzoek naartoe moet worden gestuurd. alias definieert een verkorte naam om binnen Vibe te gebruiken, en temperature stelt de creativiteit in, van 0,0 voor deterministisch gedrag tot 1,0 voor een meer inventief model. Voor code levert een lage waarde, zoals in het voorbeeld, veel stabielere resultaten op.
Om dit model standaard in te schakelen, hergebruikt u eenvoudigweg de alias:
active_model = "devstral-openrouter"
Volledig voorbeeld: OpenRouter
Hier is een volledige configuratie met één provider en twee gekoppelde modellen:
# ~/.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"
# Gratis 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
Configuratie alleen is niet genoeg: u moet nog steeds de omgevingsvariabele definiëren die de provider verwacht, anders gaan oproepen eruit zonder authenticatie.
export OPENROUTER_API_KEY="sk-or-votre-cle-ici"
Zodra beide modellen zijn gedeclareerd, heeft u twee uitwisselbare aliassen. Tijdens een sessie schakelt /model devstral-free tussen hen zonder het gesprek te verliezen, zodat u twee antwoorden op hetzelfde probleem kunt vergelijken. Bij het opstarten doet de optie --model hetzelfde: vibe --model llama-70b.
Lokale provider met Ollama
Het geval van een lokaal bediend model verdient een apart voorbeeld, aangezien er geen API-sleutel nodig is: het veld api_key_env_var blijft eenvoudigweg leeg.
[[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"
Het voordeel is direct: uw data verlaat nooit uw machine. Dit is de optie die u kiest om aan gevoelige code te werken, of simpelweg om te blijven coderen in de trein zonder internetverbinding.
Belangrijkste punten
- Vibe ondersteunt elke provider die compatibel is met het OpenAI API-formaat
- Declareer een provider met
[[providers]]in config.toml - Elk model is gekoppeld aan een provider en kan een alias hebben
/modellaat u tijdens een sessie tussen modellen schakelen- Lokale providers (Ollama, vLLM) maken offline werken mogelijk