Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Kľúč API a premenné prostredia

Lekcia 5 z 16 Aktualizované 2. novembra 2026 Vývojár
Na tejto strane
  1. Získanie kľúča Mistral API
  2. Tri spôsoby konfigurácie
  3. Poradie priorít
  4. Bezpečnosť kľúča API
  5. Overenie funkčnosti kľúča
  6. Kľúčové poznatky

Lekcia aktualizovaná 2. novembra 2026 na základe článku API keys and profiles: kľúč zadaný počas inštalácie sa uloží do systémového zväzku kľúčov (súbor ~/.vibe/.env slúži len ako záloha), prihlásenie cez prehliadač je predvolené a príkazy /status alebo /whoami ukazujú použitý zdroj. Zdroj: API keys and profiles.

Získanie kľúča Mistral API

Na používanie nástroja Vibe potrebuješ kľúč Mistral API. Tento kľúč overuje tvoje požiadavky a umožňuje nástroju Vibe komunikovať s modelmi Mistral. Bez neho sa síce nástroj nainštaluje a spustí, ale generovanie nie je možné. Kľúč vytvoríš v konzole Mistral v šiestich krokoch:

  1. Prejdi na console.mistral.ai
  2. Vytvor si účet alebo sa prihlás
  3. Prejdi do sekcie API Keys
  4. Klikni na Create new key
  5. Priraď mu výstižný názov (napr. „vibe-cli-dev“)
  6. Okamžite skopíruj kľúč – už sa ti nezobrazí

Posledný bod nie je len formalita: kľúč je viditeľný iba raz. Ak kartu zatvoríš príliš skoro, budeš musieť vygenerovať nový. Kľúč má formát sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx a musí zostať dôverný. Ktokoľvek, kto ho získa, môže využiť tvoju kvótu API – a teda minúť tvoj rozpočet.

Tri spôsoby konfigurácie

Nástroj Vibe akceptuje tri spôsoby poskytnutia tohto kľúča. Tvoja voľba závisí výlučne od pracovného kontextu.

Metóda 1: Interaktívne nastavenie

Toto je predvolená metóda pri prvom spustení a najjednoduchšia pre osobnú pracovnú stanicu. Nástroj Vibe sa ťa priamo opýta na kľúč a uloží ho:

vibe
# → "Please enter your Mistral API key:"
# Vlož svoj kľúč a stlač Enter

Kľúč sa uloží do systémového zväzku kľúčov (macOS Keychain, Windows Credential Manager…). Ak nie je k dispozícii žiadny zväzok kľúčov, použije sa záložný súbor ~/.vibe/.env, ktorý je čitateľný len pre teba. Všimni si, že pri prvom spustení často stačí prihlásiť sa cez prehliadač pomocou účtu Mistral, čím sa potreba zadávať kľúč úplne odpadne. Ak chceš zistiť, ktorý zdroj nástroj Vibe práve používa, zadaj počas relácie príkaz /status alebo /whoami.

# Ak je kľúč v súbore .env (nie je dostupný zväzok kľúčov)
cat ~/.vibe/.env
# MISTRAL_API_KEY=...

Metóda 2: Premenná prostredia

Akonáhle opustíš prostredie osobnej pracovnej stanice – napríklad pri CI/CD pipeline, automatizovanom skripte alebo zdieľanom serveri – je vhodnejšia premenná prostredia, pretože nič nezapisuje na disk:

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

Aby bola trvalá na tvojom stroji, pridaj tento riadok do konfiguračného súboru svojho shellu:

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

Premenná prostredia má prioritu pred súborom .env. To umožňuje veľmi praktický spôsob práce: dočasné prepínanie kľúčov bez trvalých zmien. Môžeš pracovať so svojím vývojovým kľúčom a potom pred jediný príkaz pre citlivú operáciu predradiť iný kľúč:

# Vývojový kľúč
export MISTRAL_API_KEY="sk-dev-xxxx"
vibe "Analyze this code"

# Produkčný kľúč (dočasne)
MISTRAL_API_KEY="sk-prod-yyyy" vibe "Deploy migrations"

Metóda 3: Súbor config.toml

Nakoniec môžeš odkázať na premennú prostredia priamo v konfiguračnom súbore TOML nástroja Vibe:

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

Všimni si, že tento parameter neobsahuje samotný kľúč, ale iba názov premennej, ktorú má načítať. Táto nepriamosť dáva zmysel pri práci s viacerými poskytovateľmi, kde má každý svoju vlastnú premennú: api_key_env_var hovorí nástroju Vibe, ktorú premennú má použiť ako predvolený kľúč.

Poradie priorít

Keď je súčasne nakonfigurovaných viacero metód, nástroj Vibe uplatní toto poradie:

  1. Premenná prostredia MISTRAL_API_KEY (ak je definovaná v shelli)
  2. Súbor .env v ceste ~/.vibe/.env
  3. Systémový zväzok kľúčov, kam kľúč ukladá sprievodca nastavením

Pre vlastného poskytovateľa parameter api_key_env_var v súbore config.toml jednoducho určuje premennú, ktorú treba načítať, pričom sa riadi rovnakým poradím.

Zapamätaj si prvý riadok vyššie: ak požiadavka zlyhá na overení, hoci tvoj súbor .env obsahuje platný kľúč, najprv skontroluj, či v shelli nezostala stará premenná, ktorá ho prepisuje.

Bezpečnosť kľúča API

Prvým pravidlom je nikdy neodoslať svoj kľúč do repozitára Git. Pridaj .env do súboru .gitignore ešte predtým, než súbor vôbec vytvoríš. Tajomstvo odoslané do verejného repozitára sa považuje za kompromitované, aj ak commit neskôr odstrániš. Z rovnakej logiky nezdieľaj svoj kľúč v plain texte v správe ani dokumente. Ak máš podozrenie na únik, okamžite ho vygeneruj znova.

Organizačne používaj samostatné kľúče pre vývoj a produkciu. Ak jeden unikne, môžeš ho zrušiť bez prerušenia toho druhého. Nakoniec si v konzole Mistral nastav limity míňania. Toto je najúčinnejšia bezpečnostná sieť proti skriptu v slučke alebo odhalenému kľúču: fakturácia sa automaticky zastaví.

Overenie funkčnosti kľúča

Po konfigurácii nič nepredpokladaj. Otestuj to minimálnou požiadavkou:

vibe "Say hello"

Ak je kľúč platný, nástroj Vibe odpovie normálne. Ak je neplatný alebo expirovaný, dostaneš jasnú chybu overenia, čo ťa ušetrí od zdĺhavého hľadania príčiny v inštalácii.

Ak nakonfiguruješ ďalších poskytovateľov, ako je OpenRouter, každý potrebuje svoju vlastnú premennú. Obidve môžu koexistovať bez problémov:

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

Konfiguráciu poskytovateľov tretích strán podrobne preberieme v špecializovanej lekcii.

Kľúčové poznatky

  • Získaj svoj kľúč Mistral API na console.mistral.ai
  • Tri spôsoby konfigurácie: interaktívne nastavenie, premenná prostredia, config.toml
  • Premenná prostredia má prioritu pred súborom .env
  • Nikdy neodosielaj svoj kľúč do Gitu
  • Nastav si limity míňania v konzole Mistral