Raktas API ir kintamieji aplinkoje
Šiame puslapyje
Pamoka atnaujinta 2026 m. lapkričio 2 d. pagal API raktus ir profilius: diegimo metu įvestas raktas saugomas sistemos raktinėje (failas
~/.vibe/.envyra tik atsarginis variantas), pagal nutylėjimą siūloma prisijungti per naršyklę, o/statusarba/whoaminurodo naudojamą šaltinį. Šaltinis: API keys and profiles.
Gaukite savo „Mistral“ API raktą
Norint naudoti „Vibe“, būtinas „Mistral“ API raktas. Šis raktas autentifikuoja tavo užklausas ir leidžia „Vibe“ bendrauti su „Mistral“ modeliais. Be jo įrankis įsirašo ir paleidžiamas, tačiau joks generavimas neįmanomas. Raktą „Mistral Console“ sukuri per šešis žingsnius:
- Eik į console.mistral.ai
- Susikurk paskyrą arba prisijunk
- Eik į skyrių API Keys
- Spausk Create new key
- Suteik jam aiškų pavadinimą (pvz., „vibe-cli-dev“)
- Nedelsdamas nukopijuok raktą – jis daugiau nebus rodomas
Tas paskutinis punktas nėra formalumas: raktas matomas tik vieną kartą. Jei per anksti uždarysi kortelę, teks generuoti naują. Rakto formatas yra sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ir jis turi išlikti konfidencialus. Bet kas, turintis šį raktą, gali naudoti tavo API kvotą – ir taip eikvoti tavo biudžetą.
Trys konfigūravimo būdai
„Vibe“ priima tris būdus pateikti šį raktą. Tavo pasirinkimas visiškai priklauso nuo darbo konteksto.
1 būdas: interaktyvus nustatymas
Tai numatytasis būdas pirmojo paleidimo metu ir paprasčiausias asmeninei darbo stočiai. „Vibe“ tiesiogiai paprašo rakto ir jį išsaugo:
vibe
# → "Please enter your Mistral API key:"
# Įklijuok savo raktą, paspausk Enter
Raktas saugomas tavo sistemos raktinėje (macOS Keychain, Windows Credential Manager…). Jei raktinės nėra, naudojamas atsarginis variantas – failas ~/.vibe/.env, kurį gali skaityti tik tu. Atkreipk dėmesį, kad pirmojo paleidimo metu prisijungimas per naršyklę naudojant „Mistral“ paskyrą dažnai visiškai panaikina rakto poreikį. Norėdamas pamatyti, kurį šaltinį „Vibe“ iš tikrųjų naudoja, sesijos metu įvesk /status arba /whoami.
# Jei raktas yra .env faile (nėra raktinės)
cat ~/.vibe/.env
# MISTRAL_API_KEY=...
2 būdas: aplinkos kintamasis
Kai tik išeini iš asmeninės darbo stoties aplinkos – pavyzdžiui, CI/CD konvejerio, automatizuoto scenarijaus arba bendro serverio atveju – aplinkos kintamasis tampa pageidautinesnis, nes nieko nerašo į diską:
export MISTRAL_API_KEY="sk-your-key-here"
Kad jis išliktų tavo kompiuteryje nuolatinis, pridėk šią eilutę į savo apvalkalo konfigūracijos failą:
# Faile ~/.bashrc, ~/.zshrc arba ~/.profile
export MISTRAL_API_KEY="sk-your-key-here"
Aplinkos kintamasis turi pirmenybę prieš .env failą. Tai leidžia taikyti labai praktišką naudojimo modelį: laikinai keisti raktus neatliekant nuolatinių pakeitimų. Gali dirbti naudodamas kūrimo raktą, o jautriai operacijai vienai komandai priešakyje naudoti kitą raktą:
# Kūrimo raktas
export MISTRAL_API_KEY="sk-dev-xxxx"
vibe "Analyze this code"
# Gamybos raktas (laikinai)
MISTRAL_API_KEY="sk-prod-yyyy" vibe "Deploy migrations"
3 būdas: config.toml failas
Galiausiai, „Vibe“ TOML konfigūracijos faile gali nurodyti aplinkos kintamąjį:
# ~/.vibe/config.toml
api_key_env_var = "MISTRAL_API_KEY"
Atkreipk dėmesį, kad šis parametras neturi paties rakto, o tik kintamojo pavadinimą, kurį reikia nuskaityti. Ši netiesioginė nuoroda prasminga dirbant su keliais tiekėjais, kurių kiekvienas turi savo kintamąjį: api_key_env_var nurodo „Vibe“, kurį naudoti numatytajam raktui.
Pirmenybės tvarka
Kai vienu metu sukonfigūruoti keli metodai, „Vibe“ taiko šią tvarką:
- Aplinkos kintamasis
MISTRAL_API_KEY(jei apibrėžtas apvalkale) .envfailas aplanke~/.vibe/.env- Sistemos raktinė, į kurią sąrankos vedlys išsaugo raktą
Pasirinktiniam tiekėjui api_key_env_var faile config.toml tiesiog nurodo kintamąjį, kurį reikia nuskaityti, laikantis tos pačios tvarkos.
Prisimink pirmąją aukščiau pateiktą eilutę: jei užklausa nepavyksta dėl autentifikavimo, nors tavo .env faile yra galiojantis raktas, pirmiausia patikrink, ar apvalkale nėra likęs senas kintamasis, kuris jį nustelbia.
API rakto saugumas
Pirmoji taisyklė – niekada neįkelk rakto į „Git“ saugyklą. Prieš kurdami failą, įtraukite .env į savo .gitignore. Į viešą saugyklą įkeltas slaptas raktas laikomas pažeistu, net jei vėliau ištrinsi įrašą. Tuo pačiu logiku, nebendrink rakto kaip gryno teksto žinutėje ar dokumente. Jei įtari, kad raktas nutekėjo, nedelsdamas sugeneruok naują.
Organizaciniu lygmeniu naudok atskirus raktus kūrimui ir gamybai. Jei vienas nutekės, galėsi jį panaikinti netrukdydamas kitam. Galiausiai, „Mistral Console“ nustatyk išlaidų limitus. Tai veiksmingiausias apsaugos tinklas nuo užsikimšusio scenarijaus arba atskleisto rakto: atsiskaitymas sustoja automatiškai.
Patikrink, ar raktas veikia
Po konfigūravimo nieko nelaikyk savaime suprantamu. Išbandyk minimalia užklausa:
vibe "Say hello"
Jei raktas galioja, „Vibe“ atsako įprastai. Jei jis negalioja arba pasibaigęs, gausi aiškią autentifikavimo klaidą, kuri sutaupys laiko ieškant priežasties diegimo metu.
Jei konfigūruoji papildomus tiekėjus, pavyzdžiui, „OpenRouter“, kiekvienam reikia savo kintamojo. Abu gali egzistuoti kartu be problemų:
export MISTRAL_API_KEY="sk-mistral-xxxx"
export OPENROUTER_API_KEY="sk-or-xxxx"
Išsamiau apie trečiųjų šalių tiekėjų konfigūravimą nagrinėsime atskiroje pamokoje.
Svarbiausi punktai
- Gauk savo „Mistral“ API raktą adresu console.mistral.ai
- Trys konfigūravimo būdai: interaktyvus nustatymas, aplinkos kintamasis, config.toml
- Aplinkos kintamasis turi pirmenybę prieš .env failą
- Niekada neįkelk rakto į „Git“
- „Mistral Console“ nustatyk išlaidų limitus