Eochair API agus Athróga Timpeallachta
Ar an leathanach seo
An ceacht nuashonraithe an 2 Samhain, 2026 bunaithe ar Eochracha API agus próifílí: téann an eochair a chuirtear isteach le linn an tsuiteála isteach sa bhainisteoir eochracha córais (níl an comhad
~/.vibe/.envach cúltaca), tairgtear logáil isteach tríd an mbrabhsálaí go huathoibríoch, agus léiríonn/statusnó/whoamian fhoinse a úsáideadh. Foinse: Eochracha API agus próifílí.
Faigh d’Eochair API Mistral
Chun Vibe a úsáid, teastaíonn eochair API Mistral uait. Údarásaíonn an eochair seo do chuid iarratas agus ligeann sé do Vibe cumarsáid a dhéanamh le samhlacha Mistral. Gan í, suiteáiltear agus seoltar an uirlis, ach ní féidir aon ghiniúint a dhéanamh. Cruthaíonn tú an eochair ar Chonsól Mistral i sé chéim:
- Téigh go dtí console.mistral.ai
- Cruthaigh cuntas nó logáil isteach
- Téigh go dtí an roinn API Keys
- Cliceáil ar Create new key
- Tabhair ainm cur síosach air (m.sh. “vibe-cli-dev”)
- Cóipeáil an eochair láithreach – ní thaispeánfar arís í
Ní gnáthnós é an pointe deireanach sin: ní fheictear an eochair ach uair amháin. Má dhúnann tú an cluaisín ró-luath, beidh ort ceann nua a ghiniúint. Leanann an eochair an formáid sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx agus caithfidh sí fanacht faoi rún. Is féidir le duine ar bith a bhfuil sí aige do chuóta API a úsáid – agus dá bhrí sin do bhuiséad a chaitheamh.
Trí Mhodh Cumraíochta
Glacann Vibe le trí bhealach chun an eochair seo a sholáthar. Braitheann do rogha go hiomlán ar do chomhthéacs oibre.
Modh 1: Socruithe Idirghníomhacha
Seo an modh réamhshocraithe ar an gcéad seoladh agus an ceann is simplí do stáisiún oibre pearsanta. Iarrann Vibe do eochair go díreach agus sábhálann sé í:
vibe
# → "Please enter your Mistral API key:"
# Greamaigh d'eochair, brúigh Enter
Tá an eochair stóráilte i do bhainisteoir eochracha córais (Keychain macOS, Windows Credential Manager…). Mura bhfuil aon bhainisteoir eochracha ar fáil, téann sé i muinín an chomhaid ~/.vibe/.env, nach féidir leat féin a léamh amháin. Tabhair faoi deara go mbaineann logáil isteach tríd do bhrabhsálaí le do chuntas Mistral ar an gcéad seoladh an ghá le heochair go minic. Chun a fheiceáil cén fhoinse atá Vibe ag úsáid i ndáiríre, clóscríobh /status nó /whoami le linn seisiúin.
# Má tá an eochair sa chomhad .env (gan aon bhainisteoir eochracha ar fáil)
cat ~/.vibe/.env
# MISTRAL_API_KEY=...
Modh 2: Athróg Timpeallachta
Chomh luath agus a fhágann tú timpeallacht an stáisiúin oibre phearsanta – cosúil le píblíne CI/CD, script uathoibrithe, nó freastalaí roinnte – is fearr athróg timpeallachta toisc nach scríobhann sí aon rud ar an diosca:
export MISTRAL_API_KEY="sk-your-key-here"
Chun í a dhéanamh buan ar do mheaisín, cuir an líne seo le do chomhad cumraíochta blaoisce:
# In ~/.bashrc, ~/.zshrc, nó ~/.profile
export MISTRAL_API_KEY="sk-your-key-here"
Tá tosaíocht ag an athróg timpeallachta thar an gcomhad .env. Cuireann sé seo ar do chumas patrún úsáide an-praiticiúil: athrú eochracha go sealadach gan athruithe buana a dhéanamh. D’fhéadfá oibriú le d’eochair forbartha, ansin réimír a chur le hordú amháin le heochair difriúil d’oibríocht íogair:
# Eochair forbartha
export MISTRAL_API_KEY="sk-dev-xxxx"
vibe "Analyze this code"
# Eochair táirgeachta (sealadach)
MISTRAL_API_KEY="sk-prod-yyyy" vibe "Deploy migrations"
Modh 3: Comhad config.toml
Ar deireadh, is féidir leat tagairt a dhéanamh don athróg timpeallachta i gcomhad cumraíochta TOML Vibe:
# ~/.vibe/config.toml
api_key_env_var = "MISTRAL_API_KEY"
Tabhair faoi deara nach bhfuil an eochair féin sa pharaiméadar seo, ach ainm na hathróige le léamh amháin. Tá ciall leis an indíreachacht seo agus tú ag obair le soláthraithe iolracha, a bhfuil a n-athróg féin ag gach ceann acu: insíonn api_key_env_var do Vibe cé acu ceann le húsáid don eochair réamhshocraithe.
Ord Tosaíochta
Nuair a bhíonn modhanna iolracha cumraithe ag an am céanna, cuireann Vibe an t-ord seo i bhfeidhm:
- Athróg timpeallachta
MISTRAL_API_KEY(má tá sí sainithe sa bhlaoisc) - Comhad
.envin~/.vibe/.env - Bainisteoir eochracha córais, áit a sábhálann an draoi socraithe an eochair
I gcás soláthraí saincheaptha, ní shonraíonn api_key_env_var i config.toml ach an athróg le léamh, ag leanúint an ord céanna.
Cuimhnigh ar an gcéad líne thuas: má theipeann ar iarratas údarú cé go bhfuil eochair bhailí i do .env, seiceáil ar dtús an bhfuil seanathróg fós i do bhlaoisc agus í á sárú.
Slándáil Eochracha API
Is é an chéad riail ná gan do eochair a chur riamh i stór Git. Cuir .env le do .gitignore sula gcruthaíonn tú fiú an comhad. Meastar go bhfuil rún a bhrútar chuig stór poiblí curtha i mbaol, fiú má scriosann tú an tiomantas níos déanaí. De réir na loigice céanna, ná roinn d’eochair i dtéacs simplí i dteachtaireacht nó i ndoiciméad. Má amhrasann tú go ndearnaadh sceitheadh, athghinigh láithreach í.
Go heagraíochtúil, úsáid eochracha ar leith le haghaidh forbartha agus táirgeachta. Má dhéantar sceitheadh ar cheann amháin, is féidir leat é a chúlghairm gan cur isteach ar an gceann eile. Ar deireadh, socraigh teorainneacha caiteachais ar Chonsól Mistral. Is é seo an líon sábháilteachta is éifeachtaí i gcoinne scripte lúbaí nó eochair nochta: stopann an billeáil go huathoibríoch.
Fíoraigh go nOibríonn an Eochair
Tar éis an chumraíochta, ná glac le semic mar bharántas. Déan tástáil le hiarratas íosta:
vibe "Say hello"
Má tá an eochair bailí, freagraíonn Vibe go gnáth. Mura bhfuil sí bailí nó má tá sí imithe in éag, gheobhaidh tú earráid údarúcháin shoiléir, rud a shábhálfaidh duit cuardach a dhéanamh ar an gcúis sa tsuiteáil.
Má chumraíonn tú soláthraithe breise cosúil le OpenRouter, teastaíonn a n-athróg féin ó gach ceann acu. Maireann an dá cheann le chéile gan fadhb:
export MISTRAL_API_KEY="sk-mistral-xxxx"
export OPENROUTER_API_KEY="sk-or-xxxx"
|
Pléifimid cumraíocht soláthraithe tríú páirtí go mion sa cheacht tiomnaithe.
## Príomhphointí
- Faigh d'eochair API Mistral ag console.mistral.ai
- Trí mhodh cumraíochta: socruithe idirghníomhacha, athróg timpeallachta, config.toml
- Tá tosaíocht ag an athróg timpeallachta thar an gcomhad .env
- Ná cuir d'eochair riamh i Git
- Socraigh teorainneacha caiteachais ar Chonsól Mistral