L-endpoint WebSocket u l-konnessjoni f'ħin reali
F'din il-paġna
Aġġornat fit-3 ta’ Novembru 2026, ibbażat fuq il-paġni Speech to Speech, Pricing, u Rate limits ta’ xAI: $0.08 kull minuta, sessjonijiet konkorrenti skont il-livell, u
grok-voice-3.0bħala l-mudell kurrenti. Sorsi: Speech to Speech · Pricing · Rate limits.
L-API tal-Aġent Vokali f’Ħin Reali
L-API tal-Aġent Vokali Grok (Grok Voice Agent API) tippermettilek tibni aġenti vokali konversazzjonali li jitkellmu mal-utenti tiegħek f’ħin reali. Minflok l-APIs REST klassiċi, li jaħdmu talba wara l-oħra, din l-API tuża l-protokoll WebSocket biex iżżomm konnessjoni persistenti b’direzzjonijiet doppji miftuħa bejn l-app tiegħek u s-servers ta’ xAI.

Hemm endpoint wieħed biss:
wss://api.x.ai/v1/realtime
Inti tagħżel il-mudell bil-parametru tal-URL model, pereżempju wss://api.x.ai/v1/realtime?model=grok-voice-latest. grok-voice-latest jipponta lejn grok-voice-3.0, il-mudell kurrenti, u huwa wkoll id-default. Fil-produzzjoni, xAI jirrakkomanda li tiffissa (pin) verżjoni msemmija.
Dan l-endpoint wieħed jimmaniġġja ċ-ċiklu tal-ħajja kollu ta’ konversazzjoni vokali: ir-riċeviment tal-awdjo, is-sejbien tad-diskors, il-ġenerazzjoni tar-risposta, u l-ibgħat lura tal-awdjo sintetizzat.
Iftaħ il-konnessjoni WebSocket
Biex tikkonnettja, poġġi ċ-ċavetta tal-API ta’ xAI tiegħek fl-intestazzjoni ta’ awtorizzazzjoni. Hawnhekk hemm eżempju f’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);
});
F’Python, tista’ tuża l-librerija websockets:
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())
Iċ-ċiklu tal-ħajja tas-sessjoni
Hekk kif tiftaħ il-konnessjoni WebSocket, is-server jibgħat avveniment session.created li jikkonferma li s-sessjoni hija attiva. Imbagħad tibgħat avveniment session.update biex tikkonfigura l-konversazzjoni (il-vuċi, l-istruzzjonijiet, l-għodod, is-sejbien tad-dawra).
Iċ-ċiklu tipiku jidher hekk:
- Konnessjoni: iftaħ il-WebSocket bl-awtentikazzjoni
- Konfigurazzjoni: ibgħat
session.updatebis-settings tiegħek - Konferma: irċievi
session.updatedmis-server - Konversazzjoni: skambja avvenimenti tal-awdjo u tat-test
- Għeluq: ikkonnettja mill-WebSocket b’mod nadif
Immaniġġja l-iżbalji tal-konnessjoni
Is-server jista’ jagħlaq jew jirrifjuta l-konnessjoni għal diversi raġunijiet: żball fl-awtentikazzjoni, li taqbeż il-limitu tas-sessjonijiet konkorrenti tal-livell tiegħek (10 fil-livell tad-dħul, sa 200 fl-ogħla livell), jew inċident. Id-dokumentazzjoni kurrenti ma tistabbilixxix tul massimu tas-sessjoni, u r-ripristinar tas-sessjoni (lezzjoni 4) jippermettilek terġa’ tieħu konversazzjoni wara qtugħ. L-app tiegħek għandha tinkludi loġika ta’ konnessjoni mill-ġdid b’backoff esponenzjali.
Prezzijiet ivverifikati fit-3 ta’ Novembru 2026. Il-prezzijiet jinbidu spiss: qabel ma tibbaġitja xejn, iċċekkja r-rati kurrenti fil-paġna uffiċjali tal-prezzijiet ta’ xAI.
Punti Ewlenin
- L-endpoint WebSocket
wss://api.x.ai/v1/realtimehuwa l-punt tad-dħul uniku għall-konversazzjonijiet vokali kollha - Tawtentika ruħek bl-intestazzjoni
Authorization: Bearer {Ċavetta tal-API} - In-numru ta’ sessjonijiet konkorrenti jiddependi mil-livell tiegħek: 10 fil-livell tad-dħul, sa 200
- Is-server jibgħat
session.createdmal-konnessjoni, imbagħad jistenna l-session.updatetiegħek biex tikkonfigura l-konversazzjoni - Il-prezz huwa $0.08 kull minuta, jew $4.80 kull siegħa, flimkien ma’ $0.004 kull input tat-test