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

API-avain ja ympäristömuuttujat

Oppitunti 5 / 16 Päivitetty 2. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Hanki Mistral API -avaimesi
  2. Kolme määritystapaa
  3. Prioriteettijärjestys
  4. API-avaimen turvallisuus
  5. Varmista, että avain toimii
  6. Keskeiset asiat

Oppitunti päivitetty 2. marraskuuta 2026 lähteen API-avaimet ja profiilit perusteella: asennuksen aikana syötetty avain tallennetaan järjestelmän avainnippuun (tiedosto ~/.vibe/.env on vain varavaihtoehto), selaimella kirjautuminen tarjotaan oletuksena, ja /status tai /whoami ilmoittavat käytetyn lähteen. Lähde: API-avaimet ja profiilit.

Hanki Mistral API -avaimesi

Käyttääksesi Vibeä tarvitset Mistral API -avaimen. Tämä avain todentaa pyyntösi ja mahdollistaa Viben kommunikoinnin Mistral-mallien kanssa. Ilman sitä työkalu kyllä asentuu ja käynnistyy, mutta mitään generointia ei voi suorittaa. Luot avaimen Mistral Consolessa kuudessa vaiheessa:

  1. Siirry osoitteeseen console.mistral.ai
  2. Luo tili tai kirjaudu sisään
  3. Siirry kohtaan API Keys
  4. Napsauta Create new key
  5. Anna sille kuvaava nimi (esim. “vibe-cli-dev”)
  6. Kopioi avain välittömästi – sitä ei näytetä uudelleen

Viimeinen kohta ei ole pelkkä muodollisuus: avain on näkyvissä vain kerran. Jos suljet välilehden liian aikaisin, joudut luomaan uuden avaimen. Avain noudattaa muotoa sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx, ja sen on pysyttävä luottamuksellisena. Kuka tahansa, jolla on se, voi käyttää API-kiintiöitäsi – ja siten kuluttaa budjettiasi.

Kolme määritystapaa

Vibe hyväksyy kolme tapaa syöttää tämä avain. Valintasi riippuu täysin työskentelykontekstistasi.

Tapa 1: Interaktiivinen asennus

Tämä on oletusmenetelmä ensimmäisellä käynnistyksellä ja yksinkertaisin henkilökohtaisella työasemalla. Vibe kysyy avaintasi suoraan ja tallentaa sen:

vibe
# → "Please enter your Mistral API key:"
# Liitä avaimesi ja paina Enter

Avain tallennetaan järjestelmän avainnippuun (macOS Keychain, Windows Credential Manager…). Jos avainnippua ei ole saatavilla, järjestelmä käyttää varavaihtoehtona tiedostoa ~/.vibe/.env, joka on luettavissa vain sinulle. Huomaa, että ensimmäisellä käynnistyksellä kirjautuminen selaimella Mistral-tilillesi poistaa usein avaimen syöttämisen tarpeen kokonaan. Nähdäksesi, mitä lähdettä Vibe todella käyttää, kirjoita /status tai /whoami istunnon aikana.

# Jos avain on .env-tiedostossa (avainnippua ei saatavilla)
cat ~/.vibe/.env
# MISTRAL_API_KEY=...

Tapa 2: Ympäristömuuttuja

Heti kun poistut henkilökohtaisen työaseman ympäristöstä – kuten CI/CD-putkessa, automatisoidussa skriptissä tai jaetulla palvelimella – ympäristömuuttuja on suositeltava, koska se ei kirjoita mitään levylle:

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

Tehdäksesi siitä pysyvän koneellasi, lisää tämä rivi komentotulkkinsi määritystiedostoon:

# Tiedostossa ~/.bashrc, ~/.zshrc tai ~/.profile
export MISTRAL_API_KEY="sk-your-key-here"

Ympäristömuuttujalla on etuoikeus .env-tiedostoon nähden. Tämä mahdollistaa erittäin käytännöllisen käyttötavan: avainten vaihtamisen väliaikaisesti ilman pysyviä muutoksia. Voit työskennellä kehitysavaimellasi ja sitten etuliittää yhden komennon eri avaimella arkaluonteista toimenpidettä varten:

# Kehitysavain
export MISTRAL_API_KEY="sk-dev-xxxx"
vibe "Analyze this code"

# Tuotantoavain (väliaikainen)
MISTRAL_API_KEY="sk-prod-yyyy" vibe "Deploy migrations"

Tapa 3: config.toml-tiedosto

Lopuksi voit viitata ympäristömuuttujaan Viben TOML-määritystiedostossa:

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

Huomaa, että tämä parametri ei sisällä itse avainta, vaan ainoastaan muuttujan nimen, joka luetaan. Tämä välillisyys on järkevää työskenneltäessä useiden tarjoajien kanssa, joilla kullakin on oma muuttujansa: api_key_env_var kertoo Vibelle, kumpaa käytetään oletusavaimena.

Prioriteettijärjestys

Kun useita menetelmiä on määritetty samanaikaisesti, Vibe soveltaa seuraavaa järjestystä:

  1. Ympäristömuuttuja MISTRAL_API_KEY (jos määritelty komentotulkissa)
  2. .env-tiedosto kohdassa ~/.vibe/.env
  3. Järjestelmän avainnippu, johon asennusvelho tallentaa avaimen

Mukautetulle tarjoajalle config.toml-tiedoston api_key_env_var määrittää yksinkertaisesti luettavan muuttujan noudattaen samaa järjestystä.

Muista yllä oleva ensimmäinen kohta: jos pyyntö epäonnistuu todennuksessa, vaikka .env-tiedostossasi olisi kelvollinen avain, tarkista ensin, onko komentotulkissasi vanha muuttuja, joka ohittaa sen.

API-avaimen turvallisuus

Ensimmäinen sääntö on älä koskaan commitoi avaintasi Git-varastoon. Lisää .env tiedostoon .gitignore ennen kuin edes luot tiedoston. Julkiseen varastoon työnnettyä salaisuutta pidetään vaarantuneena, vaikka poistaisit commitin myöhemmin. Samasta logiikasta johtuen älä jaa avaintasi selväkielisenä viestissä tai dokumentissa. Jos epäilet vuotoa, luo avain uudelleen välittömästi.

Organisaatiotasolla käytä erillisiä avaimia kehitykseen ja tuotantoon. Jos toinen vuotaa, voit kumota sen keskeyttämättä toista. Lopuksi aseta kulutusrajoitukset Mistral Consolessa. Tämä on tehokkain turvaverkko silmukkaan jäänyttä skriptiä tai paljastunutta avainta vastaan: laskutus pysähtyy automaattisesti.

Varmista, että avain toimii

Määrityksen jälkeen älä oleta mitaan. Testaa minimaalisella pyynnöllä:

vibe "Say hello"

Jos avain on kelvollinen, Vibe vastaa normaalisti. Jos se on virheellinen tai vanhentunut, saat selkeän todennusvirheen, mikä säästää sinua syyn etsimiseltä asennuksesta.

Jos määrität muita tarjoajia, kuten OpenRouterin, kukin niistä tarvitsee oman muuttujansa. Nämä kaksi voivat esiintyä rinnakkain ongelmitta:

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

Käsittelemme kolmansien osapuolten tarjoajien määritystä yksityiskohtaisesti omassa oppitunnissaan.

Keskeiset asiat

  • Hanki Mistral API -avaimesi osoitteesta console.mistral.ai
  • Kolme määritystapaa: interaktiivinen asennus, ympäristömuuttuja, config.toml
  • Ympäristömuuttujalla on etuoikeus .env-tiedostoon nähden
  • Älä koskaan commitoi avaintasi Gitiin
  • Aseta kulutusrajoitukset Mistral Consolessa