Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

An athróg timpeallachta XAI_API_KEY

Ceacht 3 as 14 Nuashonraithe 30 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Do eochair a stóráil go sábháilte
  2. XAI_API_KEY a shocrú
  3. An chumraíocht a sheiceáil
  4. Timpeallachtaí táirgeachta
  5. Botúin choitianta
  6. Príomhphointí

Do eochair a stóráil go sábháilte

Níor chóir go mbeadh eochair API le feiceáil riamh mar théacs simplí i do chód foinse. Is é an cur chuige caighdeánach ná í a stóráil in athróg timpeallachta a léann d’iarratas ag am tosaithe. Scarann sé seo an chumraíocht ón gcód agus cosnaíonn sé do rúin.

XAI_API_KEY a shocrú

Is é XAI_API_KEY an t-ainm athróige a úsáideann xAI agus na SDK oifigiúla go léir. Seo mar a shocraíonn tú í ar do chóras.

Linux agus macOS

I do theirminéal, cuir an athróg le do phróifíl blaoisce:

echo 'export XAI_API_KEY="xai-your-key-here"' >> ~/.bashrc
source ~/.bashrc

Má tá Zsh á úsáid agat (an réamhshocrú ar macOS), cuir .zshrc in ionad .bashrc.

Windows (PowerShell)

$env:XAI_API_KEY = "xai-your-key-here"

Chun é a dhéanamh buan, úsáid athróga timpeallachta an chórais trí Shocruithe Casta, nó rith:

[System.Environment]::SetEnvironmentVariable("XAI_API_KEY", "xai-your-key-here", "User")

Comhad .env (tionscadail áitiúla)

Do thionscadail a úsáideann creatlach (Node.js, Django, Flask), cruthaigh comhad .env ag an bhfréamh:

XAI_API_KEY=xai-your-key-here

Caithfidh tú .env a chur le do chomhad .gitignore ionas nach gcuirfidh tú do rúin i dtaisce i stór Git:

# .gitignore
.env
.env.local
.env.*.local

An chumraíocht a sheiceáil

Déan tástáil chun a fháil amach an bhfuil an athróg ar fáil:

echo $XAI_API_KEY

Ba chóir go bhfeicfeá do eochair. Má thugann an t-ordú líne fholmh ar ais, athluchtaigh do phróifíl blaoisce nó atosigh do theirminéal.

I bPython, is féidir leat é a sheiceáil mar seo:

import os
key = os.getenv("XAI_API_KEY")
print("Key configured" if key else "Variable missing")

Timpeallachtaí táirgeachta

I dtimpeallachtaí táirgeachta, ná húsáid comhad .env. Ina ionad sin, úsáid meicníochtaí ionsuite do hardáin:

  • Docker: docker run -e XAI_API_KEY=xai-xxx my-image
  • Kubernetes: Rún (Secret) suiteáilte mar athróg timpeallachta
  • Vercel / Netlify / Railway: athróga i ndeasc rialaithe an tionscadail
  • GitHub Actions: rúin stórtha (${{ secrets.XAI_API_KEY }})

Criptíonn na córais seo rúin agus iad ar fos agus insteallann siad iad ag am rite amháin.

Botúin choitianta

  • Comharthaí athfhriotail breise san eochair: má tá comharthaí athfhriotail litriúla san athróg, teipfidh ar iarratais le hearráid fíordheimhnithe
  • Athróg socraithe i mblaoisc eile: níl athróga ó theirminéal amháin ar fáil i gceann eile mura ndéantar iad a onnmhairiú i do phróifíl
  • Spásanna timpeall an chomhartha =: i gcomhad .env, d’fhéadfadh teip a bheith ar an gcomhréir XAI_API_KEY = luach le spásanna, ag brath ar an leabharlann a úsáideann tú

Príomhphointí

  • Úsáid an athróg XAI_API_KEY, a aithníonn gach SDK xAI
  • Ná codáil an eochair go crua riamh i do chód foinse
  • Cuir .env le .gitignore do chuid tionscadal go léir
  • I dtimpeallachtaí táirgeachta, úsáid rúin ionsuite d’ardán óstála