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

An API xAI do dhíoltóirí

Ceacht 15 as 16 Nuashonraithe 29 Iúil 2026 Doicnéir
Ar an leathanach seo
  1. Grok a thógáil isteach i d’fheidhmchláir
  2. Réamhriachtanais
  3. Socruithe tosaigh
  4. Do chéad iarratas
  5. Cad a nochtann an API
  6. Roghnaigh do mhúnla
  7. Teorainneacha ráta agus dea-chleachtais
  8. Príomhphointí

Grok a thógáil isteach i d’fheidhmchláir

Is féidir gach rud a d’fhoghlaim tú a dhéanamh sa chomhéadan Grok a spreagadh ó do chód féin. Tugann API xAI na cumais sin isteach i d’fheidhmchláir, i do shuíomhanna gréasáin, agus i do sheirbhísí: ní áit a dtéann tú a thuilleadh an comhrá, ach feidhm a ghlaonn do tháirge air.

Réamhriachtanais

Tá ceithre rud ag teastáil uait sula scríobhann tú do chéad líne cóid:

  1. Cuntas xAI cruthaithe ag accounts.x.ai
  2. Eochair API ginte ar console.x.ai
  3. Modh íocaíochta socraithe (chun dul thar an gcúóta saor in aisce)
  4. Timpeallacht forbartha Python nó JavaScript

Is iad an chéad dá rud na rudaí atá déanta agat cheana féin sa chúrsa seo: déileálann an cuntas le fíordheimhniú, agus aithníonn an eochair d’fheidhmchlár don API. Ní thagann an modh íocaíochta i gceist ach nuair a sháraíonn do úsáid an cúóta saor in aisce, rud a tharlaíonn níos tapúla ná mar a shílfeá a luaithe a ritheann seirbhís go leanúnach. Maidir leis an timpeallacht, tá na huirlisí is fearr ag Python agus JavaScript, ach ós rud é go labhraíonn an API HTTP, déanfaidh aon teanga ar féidir léi iarratas a sheoladh an obair.

Socruithe tosaigh

Is é an chéad chéim do eochair API a stóráil go slán, i athróg timpeallachta:

export XAI_API_KEY="xai-your-key-here"

Ná cuair do eochair riamh i do chód foinse. Is é an fáth ná gnáthcheann: críochnaíonn eochair atá scríofa i gcomhad i stór Git sooner nó later, agus déantar leas as eochair a bhrútar chuig stór poiblí laistigh de nóiméad ag róbaí a scanálann gealltanais, fad a fhanann an bille ar do ainmse.

Ansin, tagann roghnú SDK. Suiteáiltear SDK dúchasach xAI do Python le pip install xai-sdk. Má ghlaonn do chód ar OpenAI cheana féin, oibríonn an leabharlann openai mar atá, buíochas le comhoiriúnacht formáide. Ar thaobh JavaScript, cuireann tú SDK AI Vercel leis le npm install ai @ai-sdk/xai, agus déanann sé comhtháthú le feidhmchláir React agus Next.js.

Do chéad iarratas

Leis an SDK dúchasach, tógann sé trí líne an cliant a chruthú agus comhrá a oscailt:

from xai_sdk import Client
import os

client = Client(api_key=os.getenv("XAI_API_KEY"))
response = client.chat.create(model="grok-4.5")

Tá an bealach atá comhoiriúnach le OpenAI chomh díreach céanna: ní athraíonn ach an base_url i gcomparáid leis an gcód atá ann cheana, rud a fhágann go n-aistríonn go leor foirne thairis i gceann cúpla nóiméad.

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1"
)

response = client.responses.create(
    model="grok-4.5",
    input="Explain machine learning to me in 3 sentences."
)

Chun a sheiceáil go n-oibríonn eochair sula scríobhann tú aon chód fiú, ní bhíonn aon rud níos fearr ná glao líne na n-orduithe:

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "input": "Hi, how are you?"
  }'

Cad a nochtann an API

Is é bunús an chórais ná giniúint téacs (freagraí comhráite, scríbhneoireacht, anailís), in éineacht le mód réasúnaíochta a réitíonn fadhbanna casta céim ar chéim. Cuireann sruthú leis sin trí fhreagra a sheachadadh token ar token in ionad fanacht go gcríochnaíonn an ghiniúint.

Tugann tacar eile rochtain ar fhaisnéis: cuardach gréasáin agus X fíor-ama, agus RAG, a dhéanann ceisteanna ar bhailiúcháin doiciméad atá tógtha agat. Clúdaíonn an taobh ilmhóideach tuiscint a fháil ar íomhánna a sholáthraíonn tú, íomhánna agus físeáin a ghiniúint le grok-imagine, agus guth, le comhráite labhartha agus TTS.

Ar deireadh, déanann trí mheicníocht an API a bheith in-ríomhchláraithe sa chiall dhian: glaonna feidhme, a ligeann don mhúnla do chuid feidhmeanna féin a ghlaow; aschuir struchtúrtha, a ráthaíonn JSON inúsáidte gan iar-phróiseáil bhristeach; agus feidhmiú cóid taobh freastalaí.

Roghnaigh do mhúnla

Athraíonn an réasúnaíocht de réir an mhúnla. Tairgeann grok-4.7, an bratbhata, réasúnaíocht inchumraithe: socraíonn an paraiméadar reasoning_effort (low, medium, high, nó xhigh) cé chomh domhain agus a smaoiníonn sé, ar iarratas ar iarratas. Fanann grok-4.3 mar an rogha buiséid le comhthéacs an-fhada, ag thart ar leathphraghas. Tá leaganacha neamh-réasúnaíochta de na samhlacha ann do thascanna simplí: ní gá machnamh inmheánach le haghaidh athfhoirmliú nó aicmiú.

Bíonn tionchar ag comhshainithe ainmniúcháin ar chobhsaíocht d’iarratais:

  • grok-4.20: an leagan cobhsaí is déanaí a mholtar
  • grok-4.20-latest: an leagan is déanaí (féadfaidh sé athrú)
  • grok-4.20-0309: leagan pinnte ar dháta sonrach (9 Márta)

Sa táirgeadh, cosnaíonn leagan pinnte do leideanna ó athruithe ciúine ar an múnla; tá latest ceart go leor le haghaidh taiscéalaíochta, fad a ghlacann tú leis go bhféadfadh iompar athrú.

Teorainneacha ráta agus dea-chleachtais

Cuirtear teorainneacha ráta i bhfeidhm ag an API chun an tseirbhís a choinneáil cobhsaí: ar an leibhéal iontrála, thart ar 10 milliún token in aghaidh an nóiméid agus 1,800 iarratas in aghaidh an nóiméid do mhúnlaí cosúil le grok-4.3, agus níos mó de réir mar a ardaíonn do leibhéal. Tá a gcapanna féin, i bhfad níos ísle, ag múnlaí giniúna íomhá agus físe, ó 30 go 300 iarratas in aghaidh an nóiméid ag brath ar an múnla, mar sin coinnigh súil orthu do sheirbhís atá dírithe ar an tomhaltóir.

Scarann roinnt nósanna samhlóir ó chomhtháthú soladach. Cuir sruthú ar siúl le haghaidh freagraí fada, toisc go mbraitheann tríocha soicind os comhair scáileáin bháin cosúil le briseadh amach. Seol ID comhrá chun tairbhe a bhaint as taisceadh. Seol gach tasc chuig an múnla ceart: grok-4.3 le haghaidh toirte simplí, grok-4.20 le haghaidh réasúnaíochta. Déileáil le hearráidí le hiarratais athfhillteacha agus cúltarraingt easpónantúil, nó casfaidh buaic tráchta ina tuile d’iarratais diúltaithe. Agus coinnigh súil ar do úsáid sa chonsól sula bhfaigheann tú amach an t-iomlán ag deireadh na míosa.

Príomhphointí

  • Tá API xAI comhoiriúnach le formáid OpenAI, rud a fhágann go bhfuil an t-aistriú éasca
  • Tá roinnt SDK ar fáil: xAI dúchasach, OpenAI, agus SDK AI Vercel
  • Clúdaíonn an API téacs, íomhánna, físeáin, guth, agus cuardach
  • Dhá leibhéal múnlaí: grok-4.7 (bratbhata, réasúnaíocht inchumraithe) agus grok-4.3 (buiséad, comhthéacs 1M)
  • Stóráil do eochair API i athróg timpeallachta i gcónaí, ná cuair riamh é