Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Lisää mukautettuja tarjoajia

Oppitunti 7 / 16 Päivitetty 2. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Miksi käyttää kolmansien osapuolten tarjoajia?
  2. Tarjoajan rakenne
  3. Esimerkkejä yleisistä tarjoajista
  4. Mallin määrittäminen tarjoajalle
  5. Täydellinen esimerkki: OpenRouter
  6. Paikallinen tarjoaja Ollamalla
  7. Keskeiset asiat

Päivitetty 2. marraskuuta 2026 — Devstral. Devstral 2 (devstral-2512) poistui käytöstä 31. heinäkuuta 2026 ja Devstral Small 2 31. maaliskuuta 2026: näihin malleihin tehtyjä pyyntöjä ei enää taata. Virallinen taulukko ohjaa ne Mistral Medium 3.5:een, joka on itse vanhentunut Mistral Large 4:n hyväksi. Codestral (codestral-2508) on edelleen yleisesti saatavilla koodin täydennykseen. Tarkista mallitaulukosta, mihin -latest-aliakset osoittavat, ennen kuin käytät näitä esimerkkejä uudelleen.

Miksi käyttää kolmansien osapuolten tarjoajia?

Oletuksena Vibe kommunikoi Mistral API:n kanssa. Työkalun arkkitehtuuri on kuitenkin suunniteltu riippumattomaksi: voit lisätä minkä tahansa OpenAI API -muotoon yhteensopivan tarjoajan. Tämä ratkaisee neljä todellista tarvetta. Pääset käsiksi muiden valmistajien malleihin, kuten Claudeen, GPT:hen tai Llamaan, reitität liikenteen välityspalvelun, kuten OpenRouterin, kautta vertaillaksesi useita malleja samassa tehtävässä, osoitat paikalliseen instanssiin (Ollama, vLLM), kun koodin ei saa poistua koneelta, tai vaihdat tarjoajaa työn luonteen mukaan.

Tyypillisessä tilanteessa tiimi työskentelee päivittäin Devstral 2:n kanssa Mistral API:ssa, mutta siirtyy paikalliseen instanssiin aina, kun käsitellään asiakkaan arkistoa, johon liittyy luottamuksellisuusvaatimuksia.

Tarjoajan rakenne

Määrität tarjoajan tiedostossa config.toml käyttämällä [[providers]]-direktiiviä:

[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"

Jokaisella kentällä on erityinen rooli:

  • name — Tarjoajan yksilöllinen tunniste (käytetään mallien viittaamiseen)
  • api_base — API:n perus-URL (pääte /chat/completions liitetään automaattisesti)
  • api_key_env_var — Sen ympäristömuuttujan nimi, joka sisältää API-avaimen
  • api_style — API:n muoto. Käytä arvoa "openai" kaikille OpenAI-yhteensopiville tarjoajille
  • backend — Taustajärjestelmän tyyppi. "generic" toimii useimmissa tapauksissa

Klassinen sudenkuoppa liittyy kohtaan api_base: koska Vibe lisää itse pääteen /chat/completions, URL-osoite, joka sisältää jo tämän suffiksin, johtaa virheelliseen osoitteeseen ja vaikeasti diagnosoitavaan verkkovirheeseen.

Esimerkkejä yleisistä tarjoajista

Tässä ovat arvot yleisimmille palveluille. Kahdella paikallisella tarjoajalla ei ole avainmuuttujaa, sillä ne eivät vaadi tunnistautumista.

Tarjoajaapi_baseapi_key_env_var
OpenRouterhttps://openrouter.ai/api/v1OPENROUTER_API_KEY
Ollama (paikallinen)http://localhost:11434/v1—
Together AIhttps://api.together.xyz/v1TOGETHER_API_KEY
Groqhttps://api.groq.com/openai/v1GROQ_API_KEY
vLLM (itse isännöity)http://votre-serveur:8000/v1—

Mallin määrittäminen tarjoajalle

Pelkkä tarjoajan määrittäminen ei riitä: sinun on myös liitettävä käyttämäsi mallit.

[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-openrouter"
temperature = 0.2

Kenttä name toistaa mallitunnisteen täsmälleen sellaisena kuin tarjoaja sen tuntee, merkki merkiltä. Kentän provider on vastattava aiemmin määritetyn tarjoajan name-arvoa, muuten Vibe ei tiedä, minne pyyntö lähetetään. alias määrittelee lyhyen nimen, jota käytetään Vibessä, ja temperature asettaa luovuustason: 0,0 deterministiseen toimintaan ja 1,0 kekseliäämpään malliin. Koodia varten pieni arvo, kuten esimerkissä, tuottaa paljon vakaampia tuloksia.

Ottaaksesi tämän mallin käyttöön oletuksena, käytä yksinkertaisesti sen aliasta uudelleen:

active_model = "devstral-openrouter"

Täydellinen esimerkki: OpenRouter

Tässä on täydellinen määritys, jossa on yksi tarjoaja ja kaksi siihen liitettyä mallia:

# ~/.vibe/config.toml

# OpenRouter-tarjoaja
[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"

# Ilmainen Devstral-malli OpenRouterin kautta
[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-free"
temperature = 0.2

# Llama-malli OpenRouterin kautta
[[models]]
name = "meta-llama/llama-3.3-70b-instruct"
provider = "openrouter"
alias = "llama-70b"
temperature = 0.3

Pelkkä määritys ei riitä: sinun on myös määritettävä tarjoajan odottama ympäristömuuttuja, muuten pyynnöt lähtevät ilman tunnistautumista.

export OPENROUTER_API_KEY="sk-or-votre-cle-ici"

Kun molemmat mallit on määritetty, sinulla on kaksi keskenään vaihdettavaa aliasta. Istunnon aikana komento /model devstral-free vaihtaa niiden välillä menettämättä keskustelua, jolloin voit verrata kahta vastausta samaan ongelmaan. Käynnistyksen yhteydessä valitsin --model tekee saman asian: vibe --model llama-70b.

Paikallinen tarjoaja Ollamalla

Paikallisesti palvelletun mallin tapaus ansaitsee oman esimerkkinsä, sillä se ei vaadi API-avainta: kenttä api_key_env_var jää yksinkertaisesti tyhjäksi.

[[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"

Etuna on suoraviivaisuus: datasi ei koskaan poistu koneeltasi. Tämä on valittava vaihtoehto, kun työskentelet arkaluonteisen koodin parissa, tai yksinkertaisesti pitääksesi koodaamisen mahdollisena junassa ilman internet-yhteyttä.

Keskeiset asiat

  • Vibe tukee kaikkia OpenAI API -muotoon yhteensopivia tarjoajia
  • Määritä tarjoaja käyttämällä [[providers]] tiedostossa config.toml
  • Jokainen malli liitetään tarjoajaan ja sille voidaan antaa alias
  • /model mahdollistaa mallien vaihtamisen istunnon aikana
  • Paikalliset tarjoajat (Ollama, vLLM) mahdollistavat offline-työskentelyn