Het WebSocket-eindpunt en de realtime verbinding
Op deze pagina
Bijgewerkt op 3 november 2026, gebaseerd op de xAI-pagina’s Speech to Speech, Pricing en Rate limits: $0,08 per minuut, gelijktijdige sessies per tier, en
grok-voice-3.0als het huidige model. Bronnen: Speech to Speech · Pricing · Rate limits.
De realtime Voice Agent API
Met de Grok Voice Agent API bouwt u conversationele voice-agents die in realtime met uw gebruikers spreken. In tegenstelling tot klassieke REST-API’s, die verzoek per verzoek werken, gebruikt deze API het WebSocket-protocol om een persistente tweerichtingsverbinding open te houden tussen uw applicatie en de servers van xAI.

Er is slechts één eindpunt:
wss://api.x.ai/v1/realtime
U kiest het model met de URL-parameter model, bijvoorbeeld wss://api.x.ai/v1/realtime?model=grok-voice-latest. grok-voice-latest verwijst naar grok-voice-3.0, het huidige model, en is ook de standaardwaarde. Voor productie raadt xAI aan om een specifieke versienaam vast te pinnen.
Dit ene eindpunt beheert de volledige levenscyclus van een voice-gesprek: audio ontvangen, spraak detecteren, het antwoord genereren en de gesynthetiseerde audio terugsturen.
De WebSocket-verbinding openen
Om verbinding te maken, plaatst u uw xAI API-sleutel in de autorisatieheader. Hier volgt een voorbeeld in 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);
});
In Python kunt u de bibliotheek websockets gebruiken:
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())
Levenscyclus van een sessie
Zodra de WebSocket-verbinding tot stand is gebracht, stuurt de server een session.created-event om te bevestigen dat de sessie actief is. Vervolgens stuurt u een session.update-event om het gesprek te configureren (stem, instructies, tools, beurt-detectie).
De typische cyclus ziet er als volgt uit:
- Verbinding: open de WebSocket met authenticatie
- Configuratie: stuur
session.updatemet uw instellingen - Bevestiging: ontvang
session.updatedvan de server - Gesprek: wissel audio- en text-events uit
- Afsluiten: sluit de WebSocket correct af
Verbindingsfouten afhandelen
De server kan de verbinding om verschillende redenen sluiten of weigeren: een authenticatiefout, het overschrijden van het limiet voor gelijktijdige sessies van uw tier (10 op het instap-tier, tot 200 op het hoogste tier), of een incident. De huidige documentatie stelt geen maximale sessieduur in, en sessiehervatting (les 4) stelt u in staat een gesprek na een onderbreking weer op te pakken. Uw applicatie moet herverbindingslogica met exponentiële backoff bevatten.
Prijzen gecontroleerd op 3 november 2026. Prijzen wijzigen regelmatig: controleer voordat u begroottingen maakt de actuele tarieven op de officiële xAI-prijs pagina.
Belangrijkste punten
- Het WebSocket-eindpunt
wss://api.x.ai/v1/realtimeis het enige toegangspunt voor alle voice-gesprekken - U authenticeert met de header
Authorization: Bearer {API-sleutel} - Het aantal gelijktijdige sessies hangt af van uw tier: 10 op het instap-tier, tot 200
- De server stuurt
session.createdbij verbinding en wacht vervolgens op uwsession.updateom het gesprek te configureren - De prijs is $0,08 per minuut, oftewel $4,80 per uur, plus $0,004 per tekstinput