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

Gineáil eochair API

Ceacht 2 as 14 Nuashonraithe 30 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Rochtain chlárúcháin ar Grok
  2. Oscail an consól
  3. Cruthaigh do chéad eochair
  4. Dea-chleachtais bhainistíochta
  5. Billeáil nasctha le heochracha
  6. Tástáil an eochair láithreach
  7. Príomhphointí

Rochtain chlárúcháin ar Grok

Eochair API cruthaithe sa chonsól xAI Is é an eochair API an tsiombail fíordheimhniúcháin a ligeann do d’fheidhmchláir labhairt le samhlacha Grok. Gan é, ní théann aon iarratas tríd. Sa cheacht seo, treoróimid tú trí do chuid eochracha a chruthú agus a bhainistiú sa chonsól xAI.

Oscail an consól

Téigh go console.x.ai agus déan logáil isteach leis an gcuntas a chruthaigh tú sa chéim roimhe seo. Is é an consól do phríomhphainéal chun eochracha a bhainistiú, úsáid a mhonatóiriú, agus billeáil a shocrú.

Sa roghchlár taobh, oscail API Keys (conair iomlán: console.x.ai/team/default/api-keys).

Cruthaigh do chéad eochair

Cliceáil ar Create API Key. Is féidir leat ainm cur síosach a thabhairt ar gach eochair chun a chríoch a shainaithint:

  • dev-local do d’timpeallacht forbartha
  • prod-backend do do fhreastalaí táirgeachta
  • test-ci do do phíblíne comhtháthaithe leanúnaigh

Taispeántar an eochair uair amháin, nuair a chruthaíonn tú é. Cóipeáil é láithreach agus stóráil é in áit shlán (bainisteoir pasfhocal nó stóras rúnda). Má chailleann tú eochair, beidh ort ceann nua a ghiniúint.

Formáid na heochrach

Tosaíonn eochracha API xAI leis an réimír xai- agus teaghrán alfa-uimhriúil ina dhiaidh sin. Cabhraíonn an réimír sin leat iad a aithint go tapa i do chomhaid chumraíochta agus iad a bhrath má nochtar iad go taismeann sa chód foinseach.

Dea-chleachtais bhainistíochta

Eochair amháin in aghaidh na timpeallachta

Cruthaigh eochracha ar leith do gach comhthéacs. Má sceitheann eochair, is féidir leat é a chúlghairm gan do thimpeallachtaí eile a chur amú.

Rothlú rialta

Nuadaigh do chuid eochracha go tréimhsiúil, go háirithe do thimpeallachtaí táirgeachta. Tá an nós imeachta simplí: cruthaigh eochair nua, nuadaigh d’fheidhmchlár, ansin scrios an sean-eochair.

Seiceáil sula roinneann tú

Sula roinneann tú tionscadal, déan cinnte nach bhfuil aon eochair crua-chódaithe sa fhoinse. Úsáid comhaid .env a choinnítear lasmuigh den rialú leagain (cuir .env le do .gitignore).

Billeáil nasctha le heochracha

Déantar gach glao API a dhéantar le heochair a chomhaireamh agus a bhilliú. Tairgeann xAI dhá mhód:

  • Creidmheasanna réamhíoctha: ceannaíonn tú creidmheasanna roimh ré, agus baintear glaoithe díobh láithreach
  • Billeáil mhíosúil: déantar billeáil ar úsáid thar do chreidmheasanna ag deireadh na míosa

Seiceáil d’eolas billeála sa chonsól sula dtosaíonn tú ag úsáid an API, toisc nach féidir sonraisc a athrú go cúlghabhálach.

Tástáil an eochair láithreach

Tóg tríocha soicind chun an eochair a bhailíochtú sula gcuireann tú i dtionscadal é. Iarrann an tástáil is simplí liosta na samhlacha:

curl https://api.x.ai/v1/models \
  -H "Authorization: Bearer xai-your-key"

Deimhníonn freagra JSON a liostaíonn na samhlacha go bhfuil an eochair gníomhach agus go bhfuil an billeáil in ord. Ciallaíonn earráid 401 gur cóipeáladh an eochair go mícheart; léiríonn 403 fadhb ceadanna nó creidmheasanna. Sábhálfaidh diagnóis anseo, ag an bhfoinse, seisiún dífhabhtaithe duit níos déanaí i lár chód d’fheidhmchláir.

Príomhphointí

  • Cruthaíonn tú eochracha ag console.x.ai/team/default/api-keys
  • Tosaíonn siad le xai- agus taispeántar uair amháin iad
  • Cruthaigh eochair amháin in aghaidh na timpeallachta agus stóráil iad i stóras rúnda
  • Seiceáil do mhód billeála roimh aon ghlao API
  • Bailígh gach eochair nua le glao chuig /v1/models sula gcomhtháthaíonn tú é