An pointe deiridh WebSocket agus an nasc fíor-ama
Ar an leathanach seo
Nuashonraithe an 3 Samhain 2026, bunaithe ar leathanaigh Speech to Speech, Pricing, agus Rate limits de chuid xAI: $0.08 in aghaidh na nóiméide, seisiúin chomhthreomhara de réir céime, agus
grok-voice-3.0mar an tsamhail reatha. Foincí: Speech to Speech · Pricing · Rate limits.
An API Gníomhaire Gutha fíor-ama
Ligeann API Gníomhaire Gutha Grok duit gníomhairí gutha comhráite a thógáil a labhraíonn le d’úsáideoirí i bhfíor-am. Murab ionann agus APIanna REST clasaiceacha, a oibríonn ar bhonn iarratais ar iarratas, úsáideann an API seo an prótacal WebSocket chun nasc leanúnach dhá bhealach a choinneáil oscailte idir d’aip agus freastalaithe xAI.

Níl ach pointe deiridh amháin ann:
wss://api.x.ai/v1/realtime
Roghnaíonn tú an tsamhail leis an bparaiméadar URL model, mar shampla wss://api.x.ai/v1/realtime?model=grok-voice-latest. Tugann grok-voice-latest ar grok-voice-3.0, an tsamhail reatha, agus is é seo an réamhshocrú freisin. Sa táirgeadh, molann xAI leagan ainmnithe a phionnú.
Déanann an pointe deiridh seo láimhseáil ar shaolré iomlán comhrá gutha: fuaim a fháil, caint a bhrath, an freagra a ghiniúint, agus an fhuaim shintéiseach a sheoladh ar ais.
Oscail an nasc WebSocket
Chun nasc a dhéanamh, cuir do eochair API xAI sa cheanntásc údaraithe. Seo sampla i JavaScript:
const ws = new WebSocket("wss://api.x.ai/v1/realtime", {
headers: {
"Authorization": "Bearer " + process.env.XAI_API_KEY
}
});
ws.on("open", () => {
console.log("WebSocket connection established");
});
ws.on("message", (data) => {
const event = JSON.parse(data);
console.log("Event received:", event.type);
});
ws.on("close", (code, reason) => {
console.log("Connection closed:", code, reason);
});
ws.on("error", (err) => {
console.error("WebSocket error:", err);
});
I bPython, is féidir leat an leabharlann websockets a úsáid:
import asyncio
import websockets
import json
import os
async def connect():
uri = "wss://api.x.ai/v1/realtime"
headers = {
"Authorization": f"Bearer {os.environ['XAI_API_KEY']}"
}
async with websockets.connect(uri, additional_headers=headers) as ws:
async for message in ws:
event = json.loads(message)
print(f"Event: {event['type']}")
asyncio.run(connect())
Saolré an tseisiúin
Chomh luath agus a osclaítear an nasc WebSocket, seolann an freastalaí imeacht session.created ag dearbhú go bhfuil an seisiún gníomhach. Ansin, seolann tú imeacht session.update chun an comhrá a chumrú (guth, treoracha, uirlisí, braiteadh casadh).
Seo mar a bhíonn an timthriall tipiciúil:
- Nasc: oscail an WebSocket le fíordheimhniú
- Cumraíocht: seol
session.updatele do shocruithe - Deimhniú: faigh
session.updatedón bhfreastalaí - Comhrá: malartaigh imeachtaí fuaime agus téacs
- Dúnadh: dícheangail an WebSocket go glan
Láimhseáil earráidí nasctha
Is féidir leis an bhfreastalaí an nasc a dhúnadh nó a dhiúltú ar chúiseanna éagsúla: earráid fíordheimhnithe, sárú ar theorainn do chéime maidir le seisiúin chomhthreomhara (10 ar an gcéad tosaigh, suas le 200 ar an gcéim is airde), nó teagmhas. Ní shocraíonn an doiciméadú reatha uasmhéid faid seisiúin, agus ligeann athshumú seisiúin (ceacht 4) duit comhrá a thógáil arís tar éis titim. Ba chóir go mbeadh loighic athnascadh le cúlú easpónantúil san áireamh i d’aip.
Seiceáladh praghsanna an 3 Samhain 2026. Athraíonn praghsanna go minic: sula ndéanann tú aon bhuiséadú, seiceáil na rátaí reatha ar leathanach oifigiúil praghsanna xAI.
Príomhphointí
- Is é an pointe deiridh WebSocket
wss://api.x.ai/v1/realtimean t-aon iontráil do gach comhrá gutha - Déanann tú fíordheimhniú leis an gceanntásc
Authorization: Bearer {eochair API} - Braitheann líon na seisiún comhthreomhar ar do chéim: 10 ar an gcéad tosaigh, suas le 200
- Seolann an freastalaí
session.createdar nascadh, ansin fanann sé le dosession.updatechun an comhrá a chumrú - Is é $0.08 in aghaidh na nóiméide an praghas, nó $4.80 in aghaidh na huaire, móide $0.004 in aghaidh gach ionchur téacs