Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Ključ API-ja i varijable okruženja

Lekcija 5 od 16 Ažurirano 2. studenoga 2026. Programer
Na ovoj stranici
  1. Nabavi svoj Mistral API ključ
  2. Tri metode konfiguracije
  3. Redoslijed prioriteta
  4. Sigurnost API ključa
  5. Provjeri funkcionira li ključ
  6. Ključne točke

Lekcija ažurirana 2. studenog 2026. na temelju API ključeva i profila: ključ unesen tijekom instalacije pohranjuje se u sustavni privjesak za ključeve (datoteka ~/.vibe/.env služi samo kao rezervna opcija), prijava putem preglednika nudí se prema zadanim postavkama, a /status ili /whoami pokazuju korišteni izvor. Izvor: API keys and profiles.

Nabavi svoj Mistral API ključ

Za korištenje alata Vibe potreban ti je Mistral API ključ. Taj ključ autentificira tvoje zahtjeve i omogućuje Vibeu komunikaciju s Mistral modelima. Bez njega alat se može instalirati i pokrenuti, ali generiranje nije moguće. Ključ stvaraš u Mistral konzoli u šest koraka:

  1. Odi na console.mistral.ai
  2. Stvori račun ili se prijavi
  3. Navigiraj do odjeljka API Keys
  4. Klikni Create new key
  5. Daj mu opisno ime (npr. “vibe-cli-dev”)
  6. Odmah kopiraj ključ – više ga nećeš moći vidjeti

Posljednja točka nije puka formalnost: ključ je vidljiv samo jednom. Ako prerano zatvoriš karticu, morat ćeš generirati novi. Ključ prati format sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx i mora ostati povjerljiv. Svatko tko ga posjeduje može trošiti tvoju API kvotu – i time tvoj budžet.

Tri metode konfiguracije

Vibe prihvaća tri načina za proslijeđivanje ovog ključa. Tvoj izbor u potpunosti ovisi o tvom radnom kontekstu.

1. metoda: Interaktivno postavljanje

Ovo je zadana metoda pri prvom pokretanju i najjednostavnija za osobno radno mjesto. Vibe te izravno pita za ključ i sprema ga:

vibe
# → "Please enter your Mistral API key:"
# Zalijepi svoj ključ, pritisni Enter

Ključ se pohranjuje u tvoj sustavni privjesak za ključeve (macOS Keychain, Windows Credential Manager…). Ako privjesak za ključeve nije dostupan, alat koristi rezervnu opciju u datoteci ~/.vibe/.env, koju može čitati samo ti. Imaj na umu da pri prvom pokretanju prijava putem preglednika s tvojim Mistral računom često u potpunosti uklanja potrebu za ključem. Da bi vidio koji izvor Vibe zapravo koristi, upiši /status ili /whoami tijekom sesije.

# Ako je ključ u .env datoteci (privjesak za ključeve nije dostupan)
cat ~/.vibe/.env
# MISTRAL_API_KEY=...

2. metoda: Varijabla okruženja

Čim izađeš iz okruženja osobnog radnog mjesta – poput CI/CD pipelinea, automatizirane skripte ili dijeljenog poslužitelja – varijabla okruženja postaje poželjnija jer ništa ne zapisuje na disk:

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

Da bi je učinio trajnom na svom računalu, dodaj ovaj redak u svoju konfiguracijsku datoteku ljuske:

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

Varijabla okruženja ima prioritet nad .env datotekom. To omogućuje vrlo praktičan obrazac korištenja: privremeno prebacivanje ključeva bez trajnih promjena. Možeš raditi sa svojim razvojnim ključem, a zatim prefiksirati jednu naredbu drugačijim ključem za osjetljivu operaciju:

# Razvojni ključ
export MISTRAL_API_KEY="sk-dev-xxxx"
vibe "Analyze this code"

# Produkcijski ključ (privremeno)
MISTRAL_API_KEY="sk-prod-yyyy" vibe "Deploy migrations"

3. metoda: config.toml datoteka

Konačno, varijablu okruženja možeš referencirati u Vibeuvoj TOML konfiguracijskoj datoteci:

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

Imaj na umu da ovaj parametar ne sadrži sam ključ, već samo ime varijable koju treba pročitati. Ova neizravnost ima smisla kada radiš s više pružatelja usluga, od kojih svaki ima svoju varijablu: api_key_env_var govori Vibeu koju varijablu koristiti za zadani ključ.

Redoslijed prioriteta

Kada su istovremeno konfigurirane više metoda, Vibe primjenjuje sljedeći redoslijed:

  1. Varijabla okruženja MISTRAL_API_KEY (ako je definirana u ljusci)
  2. .env datoteka u ~/.vibe/.env
  3. Sustavni privjesak za ključeve, gdje čarobnjak za postavljanje pohranjuje ključ

Za prilagođenog pružatelja usluga, api_key_env_var u config.toml jednostavno označava varijablu koju treba pročitati, slijedeći isti redoslijed.

Zapamti prvi redak gore: ako zahtjev ne uspije zbog autentifikacije unatoč tome što tvoja .env datoteka sadrži valjani ključ, prvo provjeri lebdi li stara varijabla u tvojoj ljusci i nadjačava li je.

Sigurnost API ključa

Prvo pravilo je nikada ne commitati svoj ključ u Git repozitorij. Dodaj .env u svoj .gitignore prije nego što uopće stvoriš datoteku. Tajna koja je gurnuta u javni repozitorij smatra se kompromitiranom, čak i ako kasnije obrišeš commit. Istom logikom, nemoj dijeliti svoj ključ u običnom tekstu u poruci ili dokumentu. Ako sumnjaš na curenje, odmah ga regeneriraj.

Organizacijski, koristi odvojene ključeve za razvoj i produkciju. Ako jedan curi, možeš ga opozvati bez prekida rada drugoga. Naposljetku, postavi ograničenja trošenja u Mistral konzoli. To je najučinkovitija sigurnosna mreža protiv skripte u petlji ili otkrivenog ključa: naplata se automatski zaustavlja.

Provjeri funkcionira li ključ

Nakon konfiguracije, nemoj ništa pretpostavljati. Testiraj s minimalnim zahtjevom:

vibe "Say hello"

Ako je ključ valjan, Vibe odgovara normalno. Ako je nevaljan ili istekao, dobit ćeš jasnu pogrešku autentifikacije, što će te poštedjeti traženja uzroka u instalaciji.

Ako konfiguriraš dodatne pružatelje usluga poput OpenRoutera, svaki treba svoju varijablu. Dva ključa mogu nesmetano suživjeti:

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

Konfiguraciju pružatelja trećih strana detaljno ćemo obraditi u namjenskoj lekciji.

Ključne točke

  • Nabavi svoj Mistral API ključ na console.mistral.ai
  • Tri metode konfiguracije: interaktivno postavljanje, varijabla okruženja, config.toml
  • Varijabla okruženja ima prioritet nad .env datotekom
  • Nikada ne commitaj svoj ključ u Git
  • Postavi ograničenja trošenja u Mistral konzoli