Comhchomharthaí sealadacha le haghaidh ceangail WebSocket
Ar an leathanach seo
An fhadhb: cliant a fhíordheimhniú gan d’eochair a nochtadh
Nuair a bhíonn tú ag tógáil aipe gutha nó fíor-ama leis an API Grok, ní mór duit ceangal WebSocket a bhunú go díreach ón mbrabhsálaí nó ón gcliant soghluaiste. Cuireann seoladh tráchta trí do fhreastalaí moill leis a bhriseann comhrá gutha sreabhach. Ach cruthaíonn ceangail dhíreacha fadhb fíordheimhniúcháin: ní mór duit d’eochair API a chur san áireamh i gcód taobh an chliaint riamh.
Is simplí an fáth: aon eochair atá leabaithe i JavaScript front-end, in aip soghluaiste is féidir a dhíchódiú, nó i ndéantúsán dáilte, déantar é a shárú an tsoicind a fhoilsíonn tú é. Is féidir le haon úsáideoir uirlisí forbróra a mbrabhsálaí a oscailt agus é a léamh. Chun é seo a réiteach, cuireann xAI comhchomharthaí sealadacha ar fáil: comhchomharthaí sealadacha is féidir le cliaint a úsáid gan an eochair mháistir a fheiceáil riamh.
Conas a oibríonn comhchomharthaí sealadacha
Leanann an ailtireacht prionsabal amháin: ní fhágann an eochair API do fhreastalaí riamh, agus ní fhaigheann an cliant ach comhchomhartha gearrshaolach. Is gairid an sreabhadh. Iarrann an cliant comhchomhartha ó do chúlchóras, a ghlaonn POST /v1/realtime/client_secrets le d’eochair API. Is é an glao seo an t-aon áit a bhfeictear an eochair, agus tarlaíonn sé go hiomlán ar an taobh freastalaí. Tugann xAI comhchomhartha sealadach ar ais lena dháta éaga, a chuireann do chúlchóras ar aghaidh chuig an gcliant. Ansin osclaíonn an cliant an ceangal WebSocket le wss://api.x.ai/v1/realtime agus an comhchomhartha seo á thaispeáint aige. Ag aon phointe, ní fheiceann an brabhsálaí an eochair mháistir; láimhseálann sé comhchomhartha a éagann leis féin.
Seo mar a dhéanann do chúlchóras an glao cruthaithe:
curl -X POST https://api.x.ai/v1/realtime/client_secrets \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"expires_after": {"seconds": 600}}'
Agus an freagra:
{
"value": "Bearer eyJhbGciOiJSUzI1NiIs...",
"expires_at": 1712001200
}
Maidir le fad, tá trí thagarmharc agat: níl aon urlár doiciméadaithe ann (tá cúpla soicind indéanta), is é 600 soicind (10 nóiméad) an luach réamhshocraithe, agus is é 3600 soicind (uair an chloig) an t-uasmhéid.
An fad ceart a roghnú
Ní mór go mbeadh fad an chomhchomhartha oiriúnach do do chás úsáide, agus is cinneadh slándála fíor é an rogha seo. Maidir le hidirghníomhaíochtaí gutha ócáideacha—ceist agus freagra, ordú gutha, deachtú—tá fuinneog 300 go 600 soicind go leor: beidh an seisiún críochnaithe i bhfad roimh éag. Maidir le comhráite gutha leanúnacha cosúil le tacaíocht do chustaiméirí, agallamh, nó cruinniú faoi chúnamh, díriú ar 600 go 1800 soicind chun gan baint a bheith as an gcomhrá i lár an áit. D’fhéadfadh seisiúin oibre fadaithe—tras-scríobh fíor-ama, monatóireacht ghutha leanúnach—údar a thabhairt le 1800 go 3600 soicind, ach bain úsáid as an uasmhéid faid go cúramach: leathnaíonn sé an fhuinneog leasaithe má ghoidtear an comhchomhartha.
Is é seo an riail órga i mbeagán focal: roghnaigh i gcónaí an fad is giorra atá comhoiriúnach le do chás úsáide. Má idirghabhtar comhchomhartha, déanann éag deich nóiméad eachtra a d’fhéadfadh a bheith tromchúiseach ina ábhar beag míchaoithiúlachta.
Cur chun feidhme sa chúlchóras
Seo sampla de sheachfhreastalaí slán i Node.js:
// Bealach cúilchórais - NÁ nocht taobh an chliaint
app.post("/api/realtime-token", authenticateUser, async (req, res) => {
const response = await fetch(
"https://api.x.ai/v1/realtime/client_secrets",
{
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.XAI_API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
expires_after: { seconds: 600 }
})
}
);
const token = await response.json();
res.json({ token: token.value, expires_at: token.expires_at });
});
Tá slándáil iomlán an tsocraithe ag brath ar thrí mhionsonra sa sampla seo. Fanann an eochair API in athróg timpeallachta freastalaí, riamh sa chód. Fíordheimhníonn an meánearra authenticateUser céannacht an úsáideora sula n-eisítear comhchomhartha—gan é sin, d’fhéadfadh aon duine comhchomharthaí a fháil agus do chuóta a úsáid ar do chostas. Agus ní thugtar ach an comhchomhartha sealadach, riamh an eochair, ar ais don chliant.
Tagann roinnt paistí chun cinn go rialta in athbhreithnithe cóid. Sleamhnaíonn an eochair API isteach sa chuid tosaigh “díreach don phrótaitíopa” agus críochnaíonn sé i dtáirgeadh gan teip. Cruthaítear an comhchomhartha go córasach leis an uasmhéid faid, ar mhaithe le héascaíocht, nuair a éilíonn an cás úsáide ceathrú den méid sin. Fágfar an pointe deiridh giniúna gan fíorú fíordheimhniúcháin, oscailte do chách. Agus easpa láimhseála athnuachana ar thaobh an chliaint, a chruthaíonn earráidí éaga i lár an tseisiúin in ionad athcheangail thrédharcach: ós rud é go dtugann an freagra expires_at duit, tá gach rud atá ag teastáil ag do chliant chun comhchomhartha nua a iarraidh roimh an spriocdháta seachas ina dhiaidh.
Príomhphointí
- Cumasaíonn comhchomharthaí sealadacha fíordheimhniú WebSocket gan d’eochair API a nochtadh
- Pointe deiridh:
POST /v1/realtime/client_secrets(glao taobh freastalaí amháin) - Fad inchoigeartaithe ó chúpla soicind suas le 3600 soicind ar a mhéad (réamhshocraithe: 600s)
- Feidhmíonn do chúlchóras mar seachfhreastalaí fíordheimhniúcháin idir an cliant agus xAI
- Roghnaigh i gcónaí an fad is giorra atá comhoiriúnach le do húsáid