Ceanntáscanna API agus Bainistiú Sárshreabha
Ar an leathanach seo
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: truecumas soláthraithe d’iarratas - Ródaíonn an ceanntásc
x-pt-idchuig 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á