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

Ceanntáscanna API agus Bainistiú Sárshreabha

Ceacht 8 as 14 Nuashonraithe 28 Iúil 2026 Meánleibhéal
Ar an leathanach seo
  1. Cinntigh cé na hiarratais a ídíonn do chumas
  2. Seachain do chumas tiomnaithe go deonach
  3. Iarratas a stiúradh chuig linn shonrach
  4. Cad a tharlaíonn i gcás sárshreafa
  5. Tosaíocht a aistriú go cód feidhmchláir
  6. Príomhphointí

Cinntigh cé na hiarratais a ídíonn do chumas

Ní réitíonn cur in áirithe ach leath na faidhbe: ní mór duit fós a roghnú cé na hiarratais a thairbhíonn de i ndáiríre. Ní ceannach uileghabhálach é tréchur soláthraithe a dhéanann tú uair amháin ag tús na míosa; is meicníocht é a rialaíonn tú glao ar ghlao. Nochtann xAI ceanntáscanna HTTP tiomnaithe chun na críche seo a idirghabhálann, iarratas ar iarratas, idir do chumas tiomnaithe agus an linn roinnte. Mar sin, bíonn leithdháileadh seasta ina ghiuirléid oibríochtúil a láimhsíonn do fhoirne go díreach ón gcód feidhmchláir.

Seachain do chumas tiomnaithe go deonach

Is é seo an chéad cheanntásc chun iarratas a eisiamh ó do leithdháileadh:

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "x-pt-disable: true" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.3",
    "messages": [{"role": "user", "content": "Summarize this document."}]
  }'

D’fhéadfadh sé a bheith contrártha le ciall do chumas féin a thabhairt suas. Tá ceithre chás a thugann údar leis seo in oibríochtaí laethúla. Ar an gcéad dul síos, tascanna neamhchriticiúla: ní gá ráthaíocht moille do mhionanailís bhaisc a sheoltar ag 10 PM ná do phost próiseála moillithe, agus ba thrua é an leithdháileadh a íocadh as trácht idirghníomhach a chaitheamh air. Ar an dara dul síos, an cumas a chaomhnú le linn buaicphointí: trí thréchur soláthraithe a dhíchumasú ar phróiseáil thánaisteach, saoraíonn tú leithdháileadh díreach nuair a thagann iarratais tosaíochta isteach i dtoirt mhór. Úsáidtear an ceanntásc freisin le haghaidh tástála A/B, nuair is mian leat an difríocht fíor-feidhmíochta idir cumas tiomnaithe agus cumas roinnte a thomhas ar do lód féin seachas ar ghealltanas díoltóra. Faoi dheireadh, tá sé luachmhar le haghaidh dífhabhtaithe: má chuireann tú an t-iarratas tríd an linn roinnte go héigneach, inseoidh sé duit láithreach an easnamh a breathnaíodh ón gcumas soláthraithe nó ó do chód féin a thagann.

Iarratas a stiúradh chuig linn shonrach

Seo an dara ceanntásc a dhíríonn an glao chuig linn chumais aitheanta:

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "x-pt-id: pool-support-client" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.3",
    "messages": [{"role": "user", "content": "How can I help you?"}]
  }'

Éiríonn an ceanntásc seo riachtanach a luaithe a dhéanann iliomad feidhmchlár laistigh d’eagraíocht glaoch ar Grok. Cruthaíonn tú linnte ar leith ansin – pool-support don chatbot tacaíochta do chustaiméirí, pool-analysis d’anailís doiciméad, pool-internal d’uirlisí gnó – agus oibríonn gach ceann acu go neamhspleách. Aonaraíonn deighilt an fheidhmíocht: ní dhéanann an fheachtas anailíse doiciméad a sheoltar maidin Luan drochthionchar ar amanna freagartha na tacaíochta a thuilleadh. Táirgeann sé tomhaltas briste síos de réir úsáide freisin, agus mar sin bonn fíriciúil le haghaidh muirir inmheánacha nó idirghabhála, áit a raibh ort brath ar thuar roimhe seo. Coscaíonn sé go hinbhuanaithe freisin go ndéanfadh feidhmchlár amháin monaplacht ar an gcumas ar dhímheas feidhmchlár eile.

Cad a tharlaíonn i gcás sárshreafa

Nuair a sháraíonn an trácht an cumas soláthraithe, tá an cúltaca uathoibríoch agus ciúin: téann an t-iarratas chuig an linn roinnte ar bhonn íoc de réir mar a úsáidtear, baineann rátaí caighdeánacha an mhúnla leis, agus tá sé faoi réir teorainneacha ráta gnáthacha. Ní thugtar aon earráid ar ais; ní fheiceann d’fheidhmchlár aon rud ag tarlú.

Tá dhá thaobh ag baint leis an discrétacht seo. Ó thaobh na infhaighteachta de, tá an scéal go maith: ní bhuailfidh tú riamh le hearráid 429 de bharr sárú ar chumas soláthraithe. Ó thaobh na airgeadais agus cáilíochta seirbhíse de, níl sé chomh maith sin. Billeáiltear an t-iarratas ag an ráta íoc de réir mar a úsáidtear, ráta a d’fhéadfadh a bheith níos airde; d’fhéadfadh amanna freagartha athrú ós rud é go dtarlaíonn an phróiseáil ar bhonneagar roinnte; agus thar aon rud eile, ní chlúdaíonn an SLA 99.9% ach iarratais a phróiseáiltear laistigh de thréchur soláthraithe. Mar sin, ní bhriseann sárshreabha aon rud, ach déanann sé tú a sciorradh go ciúin amach as an raon a íocann tú as. Nochtann an Bainistíocht API an chuid d’iarratais a phróiseáiltear i mód soláthraithe i gcomparáid le híoc de réir mar a úsáidtear: scrúdaigh an cóimheas seo gach mí díreach cosúil le bille. Is comhartha é ráta sárshreafa atá ag méadú go gcaithfidh tú an leithdháileadh a mhéadú.

Tosaíocht a aistriú go cód feidhmchláir

In ionad feidhmeanna glao a iolrú, is é an cleachtas is soladaí ná tosaíocht a cháiliú ag an am a eisiatar an t-iarratas:

import httpx

def query_grok(prompt: str, priority: str = "normal"):
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json",
    }

    if priority == "low":
        headers["x-pt-disable"] = "true"
    elif priority == "high":
        headers["x-pt-id"] = "pool-critical"

    response = httpx.post(
        "https://api.x.ai/v1/chat/completions",
        headers=headers,
        json={
            "model": "grok-4.3",
            "messages": [{"role": "user", "content": prompt}],
        },
    )
    return response.json()

Is é an paraiméadar priority an t-aon chinneadh a nochtar don loighic gnó, agus fanann an polasaí ródaireachta tiomsaithe i bhfeidhm amháin a fhorbraíonn tú gan an chuid eile a bhaint. Déan athbhreithniú ar do chód glaocháin féin agus sórtáil gach pointe iontrála isteach i gceann de thrí chatagóir: léiríonn an cleachtas go rialta nach raibh gá le cumas tiomnaithe ag leath sholadach den trácht.

Príomhphointí

  • Seachnaíonn an ceanntásc x-pt-disable: true cumas soláthraithe d’iarratas
  • Ródaíonn an ceanntásc x-pt-id chuig linn chumais shonrach
  • Titann sárshreafaí go huathoibríoch ar ais go híoc de réir mar a úsáidtear gan earráid
  • Ceadaíonn deighilt i linnte feidhmíocht a aonrú agus tomhaltas a rianú de réir feidhmchláir
  • Déan monatóireacht ar an ráta sárshreafa chun do leithdháileadh a choigeartú más gá