Egyéni szolgáltatók hozzáadása
Ezen az oldalon
Frissítve: 2026. november 2. — Devstral. A Devstral 2 (
devstral-2512) élettartama 2026. július 31-én lejárt, a Devstral Small 2-é pedig 2026. március 31-én: ezekre a modellekre irányuló hívások már nem garantáltak. A hivatalos táblázat ezeket a Mistral Medium 3.5-re irányítja át, amelyet viszont a Mistral Large 4 javára már elavultnak nyilvánítottak. A Codestral (codestral-2508) továbbra is általánosan elérhető kód-kiegészítésre. Mielőtt újra felhasználnád ezeket a példákat, ellenőrizd a modelltáblázatot, hogy hová mutatnak a-latestaliasok.
Miért használj harmadik féltől származó szolgáltatókat?
Alapértelmezés szerint a Vibe a Mistral API-val kommunikál. Az eszköz architektúrája azonban szolgáltatófüggetlen: bármilyen, az OpenAI API formátumával kompatibilis szolgáltatót hozzáadhatsz. Ez négy valós igényt fed le. Hozzáférhetsz más gyártók modelljeihez – Claude, GPT, Llama –, útvonalazhatsz egy közvetítőn (pl. OpenRouter) keresztül, hogy ugyanazon a feladaton több modellt hasonlíts össze, rámutathatsz egy helyi példányra (Ollama, vLLM), amikor a kódnak nem szabad elhagynia a gépet, vagy a munka jellege alapján váltogathatod a szolgáltatókat.
Egy tipikus forgatókönyvben egy csapat naponta dolgozik a Devstral 2-vel a Mistral API-n, de átvált egy helyi példányra, amikor bizalmi korlátozások alá eső ügyféli kódtárral dolgozik.
Egy szolgáltató felépítése
Egy szolgáltatót a config.toml fájlban deklarálod a [[providers]] direktíva használatával:
[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"
Minden mezőnek sajátos szerepe van:
- name – A szolgáltató egyedi azonosítója (modellek hivatkozására használatos)
- api_base – Az API alap URL-je (a
/chat/completionsvégpont automatikusan hozzáadódik) - api_key_env_var – Annak a környezeti változónak a neve, amely az API-kulcsot tartalmazza
- api_style – Az API formátuma. Használd az
"openai"értéket bármilyen OpenAI-kompatibilis szolgáltató esetén - backend – A backend típusa. A
"generic"a legtöbb esetben működik
A klasszikus buktató az api_base körül rejlik: mivel a Vibe maga illeszti hozzá a /chat/completions utótagot, egy olyan URL, amely már tartalmazza ezt az utótagot, érvénytelen címet eredményez, és nehezen diagnosztizálható hálózati hibát okoz.
Gyakori szolgáltatók példái
Íme a legelterjedtebb szolgáltatásokhoz megadandó értékek. A két helyi szolgáltatóhoz nem tartozik kulcsváltozó, mivel nem igényelnek hitelesítést.
| Szolgáltató | api_base | api_key_env_var |
|---|---|---|
| OpenRouter | https://openrouter.ai/api/v1 | OPENROUTER_API_KEY |
| Ollama (helyi) | 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 (saját üzemeltetésű) | http://votre-serveur:8000/v1 | — |
Modell deklarálása egy szolgáltatónál
Maga a szolgáltató deklarálása nem elég: csatolnod kell a használni kívánt modelleket is.
[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-openrouter"
temperature = 0.2
A name mező pontosan, karakterről karakterre megismétli a modell azonosítóját, ahogy azt a szolgáltató ismeri. A provider mezőnek egyeznie kell egy korábban deklarált szolgáltató name értékével, különben a Vibe nem tudja, hová küldje a kérést. Az alias egy rövidített nevet definiál, amelyet a Vibén belül használhatsz, a temperature pedig a kreativitást állítja be: 0,0 a determinisztikus viselkedéshez, 1,0 a találékonyabb működéshez. Kód esetén az alacsony érték, mint ahogy a példában is látható, sokkal stabilabb eredményeket hoz.
Hogy ezt a modellt alapértelmezettként engedélyezd, egyszerűen használd újra az aliasát:
active_model = "devstral-openrouter"
Teljes példa: OpenRouter
Íme egy teljes konfiguráció egy szolgáltatóval és két csatolt modellel:
# ~/.vibe/config.toml
# OpenRouter Szolgáltató
[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"
# Ingyenes Devstral modell az OpenRouteren keresztül
[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-free"
temperature = 0.2
# Llama modell az OpenRouteren keresztül
[[models]]
name = "meta-llama/llama-3.3-70b-instruct"
provider = "openrouter"
alias = "llama-70b"
temperature = 0.3
Maga a konfiguráció nem elég: definiálnod kell a szolgáltató által várt környezeti változót is, különben a hívások hitelesítés nélkül indulnak útnak.
export OPENROUTER_API_KEY="sk-or-votre-cle-ici"
Ha mindkét modellt deklaráltad, két felcserélhető aliasszal rendelkezel. Egy munkamenet során a /model devstral-free parancs segítségével válthatsz közöttük anélkül, hogy elveszítenéd a beszélgetést, így összehasonlíthatsz két választ ugyanarra a problémára. Indításkor a --model opció ugyanezt teszi: vibe --model llama-70b.
Helyi szolgáltató Ollamával
A helyileg kiszolgált modell esete külön példát érdemel, mivel nem igényel API-kulcsot: az api_key_env_var mező egyszerűen üresen marad.
[[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"
Az előny egyértelmű: az adataid soha nem hagyják el a gépedet. Ez a választandó opció érzékeny kódokkal való munkához, vagy egyszerűen ahhoz, hogy internetkapcsolat nélkül, például vonaton is tudj kódolni.
Főbb megállapítások
- A Vibe támogat minden, az OpenAI API formátumával kompatibilis szolgáltatót
- Deklarálj egy szolgáltatót a
[[providers]]segítségével a config.toml fájlban - Minden modell hozzá van csatolva egy szolgáltatóhoz, és rendelkezhet aliasszal
- A
/modelparancs lehetővé teszi a modellek közötti váltást egy munkamenet során - A helyi szolgáltatók (Ollama, vLLM) lehetővé teszik az offline munkavégzést