Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Egyéni szolgáltatók hozzáadása

7. lecke 16 közül Frissítve 2026. november 2. Fejlesztő
Ezen az oldalon
  1. Miért használj harmadik féltől származó szolgáltatókat?
  2. Egy szolgáltató felépítése
  3. Gyakori szolgáltatók példái
  4. Modell deklarálása egy szolgáltatónál
  5. Teljes példa: OpenRouter
  6. Helyi szolgáltató Ollamával
  7. Főbb megállapítások

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 -latest aliasok.

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/completions vé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_baseapi_key_env_var
OpenRouterhttps://openrouter.ai/api/v1OPENROUTER_API_KEY
Ollama (helyi)http://localhost:11434/v1—
Together AIhttps://api.together.xyz/v1TOGETHER_API_KEY
Groqhttps://api.groq.com/openai/v1GROQ_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 /model parancs 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