Lähe põhisisu juurde
Eesti— Vali keel
Menüü

API võti ja keskkonnamuutujad

Õppetund 5 / 16 Värskendatud 2. november 2026 Arendajatele
Sellel lehel
  1. Hangi oma Mistrali API võti
  2. Kolm konfiguratsioonimeetodit
  3. Prioriteedijärjestus
  4. API võtme turvalisus
  5. Kontrolli, kas võti töötab
  6. Peamised punktid

Tund uuendatud 2. novembril 2026 põhineb teabel API võtmete ja profiilide kohta: installimisel sisestatud võti salvestatakse süsteemi võtmehoidlasse (fail ~/.vibe/.env on vaid varuvariant), vaikimisi pakutakse sisselogimist brauseri kaudu ning käsud /status või /whoami näitavad kasutatud allikat. Allikas: API keys and profiles.

Hangi oma Mistrali API võti

Vibe’i kasutamiseks vajad Mistrali API võtit. See võti autentib sinu päringud ja võimaldab Vibe’il suhelda Mistrali mudelitega. Ilma selleta tööriist küll installub ja käivitub, kuid generaator ei toimi. Loo võti Mistrali konsoolis kuue sammuga:

  1. Mine aadressile console.mistral.ai
  2. Loo konto või logi sisse
  3. Liigu sektsiooni API Keys
  4. Klõpsa Create new key
  5. Anna sellele kirjeldav nimi (nt “vibe-cli-dev”)
  6. Kopeeri võti kohe – seda enam ei näidata

Viimane punkt pole pelgalt formaalsus: võti on nähtav vaid üks kord. Kui sulged vahekaardi liiga vara, pead looma uue. Võti järgib formaati sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ja peab jääma konfidentsiaalseks. Igaüks, kes selle kätte saab, saab kasutada sinu API kvooti – ja seega kulutada sinu eelarvet.

Kolm konfiguratsioonimeetodit

Vibe aktsepteerib võtme edastamiseks kolme viisi. Sinu valik sõltub täielikult töökontekstist.

Meetod 1: Interaktiivne seadistamine

See on vaikimisi meetod esimesel käivitamisel ja lihtsaim isikliku tööjaama jaoks. Vibe küsib võtit otse ja salvestab selle:

vibe
# → "Please enter your Mistral API key:"
# Kleebi oma võti, vajuta Enter

Võti salvestatakse sinu süsteemi võtmehoidlasse (macOS Keychain, Windows Credential Manager…). Kui võtmehoidla pole saadaval, kasutatakse varufaili ~/.vibe/.env, mida saad lugeda ainult sina. Pane tähele, et esimesel käivitamisel võimaldab sisselogimine brauseri kaudu oma Mistrali kontoga sageli võtme sisestamist üldse vältida. Et näha, millist allikat Vibe tegelikult kasutab, sisesta sessiooni ajal /status või /whoami.

# Kui võti on .env failis (võtmehoidla pole saadaval)
cat ~/.vibe/.env
# MISTRAL_API_KEY=...

Meetod 2: Keskkonnamuutuja

Niipea kui lahkud isikliku tööjaama keskkonnast – olgu selleks CI/CD torustik, automatiseeritud skript või jagatud server – on keskkonnamuutuja eelistatud, kuna see ei kirjuta midagi kettale:

export MISTRAL_API_KEY="sk-your-key-here"

Et muuta see sinu masinas püsivaks, lisa see rida oma kesta konfiguratsioonifaili:

# Failis ~/.bashrc, ~/.zshrc või ~/.profile
export MISTRAL_API_KEY="sk-your-key-here"

Keskkonnamuutujal on .env faili ees prioriteet. See võimaldab väga praktilist kasutusmustrit: võtmete ajutine vahetamine ilma püsivaid muudatusi tegemata. Võid töötada oma arendusvõtmega ja seejärel eelistada ühele tundlikule operatsioonile teist võtit, lisades selle käsule prefiksina:

# Arendusvõti
export MISTRAL_API_KEY="sk-dev-xxxx"
vibe "Analyze this code"

# Tootevõti (ajutine)
MISTRAL_API_KEY="sk-prod-yyyy" vibe "Deploy migrations"

Meetod 3: config.toml fail

Lõpuks saad viidata keskkonnamuutujale Vibe’i TOML-konfiguratsioonifailis:

# ~/.vibe/config.toml
api_key_env_var = "MISTRAL_API_KEY"

Pane tähele, et see parameeter ei sisalda võtit ennast, vaid ainult muutuja nime, mida lugeda. See kaudne viide on mõttekas, kui töötad mitme pakkujaga, kellest igaühel on oma muutuja: api_key_env_var ütleb Vibe’ile, millist neist vaikimisi võtmena kasutada.

Prioriteedijärjestus

Kui mitu meetodit on samaaegselt konfigureeritud, rakendab Vibe järgmist järjekorda:

  1. Keskkonnamuutuja MISTRAL_API_KEY (kui on kestas defineeritud)
  2. .env fail asukohas ~/.vibe/.env
  3. Süsteemi võtmehoidla, kuhu seadistusviisard võtme salvestab

Kohandatud pakkuja puhul määrab api_key_env_var failis config.toml lihtsalt loetava muutuja, järgides sama järjekorda.

Pea meeles ülaltoodud esimest rida: kui päring ebaõnnestub autentimisel, kuigi sinu .env sisaldab kehtivat võtit, kontrolli esmalt, kas sinu kestas ei leidu vana muutujat, mis seda üle kirjutab.

API võtme turvalisus

Esimene reegel on mitte kunagi kommitida oma võtit Git-i hoidlasse. Lisa .env faili .gitignore-isse enne, kui faili üldse lood. Avalikku hoidlasse tõugatud saladust loetakse kompromiteerituks, isegi kui kommit hiljem kustutad. Sama loogika põhjal ära jaga oma võtit lahti kirjutatuna sõnumites või dokumentides. Kui kahtlustad lekkest, genereeri võti kohe uuesti.

Organisatsiooniliselt kasuta arenduse ja tootmise jaoks eraldi võtmeid. Kui üks lekib, saad selle tühistada, katkestamata teise tööd. Lõpuks määra Mistrali konsoolis kulupiirangud. See on kõige tõhusam ohutusvõrk silmuse jäänud skripti või lekkinud võtme vastu: arveldamine peatub automaatselt.

Kontrolli, kas võti töötab

Pärast konfiguratsiooni ära eelda midagi. Testi minimaalse päringuga:

vibe "Say hello"

Kui võti on kehtiv, vastab Vibe normaalselt. Kui see on vigane või aegunud, saad selge autentimisvea, mis säästab sind installiprobleemide põhjuse otsimisest.

Kui konfigureerid täiendavaid pakkujaid nagu OpenRouter, vajab üks neist oma muutujat. Need kaks eksisteerivad kõrvuti ilma probleemideta:

export MISTRAL_API_KEY="sk-mistral-xxxx"
export OPENROUTER_API_KEY="sk-or-xxxx"

Kolmandate osapoolte pakkujate konfiguratsiooni käsitleme üksikasjalikult spetsiaalses tunnis.

Peamised punktid

  • Hangi oma Mistrali API võti aadressilt console.mistral.ai
  • Kolm konfiguratsioonimeetodit: interaktiivne seadistamine, keskkonnamuutuja, config.toml
  • Keskkonnamuutujal on .env faili ees prioriteet
  • Ära kunagi kommiti oma võtit Gitti
  • Määra kulupiirangud Mistrali konsoolis