Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Het WebSocket-eindpunt en de realtime verbinding

Les 1 van 16 Bijgewerkt op 3 november 2026 Ontwikkelaar
Op deze pagina
  1. De realtime Voice Agent API
  2. De WebSocket-verbinding openen
  3. Levenscyclus van een sessie
  4. Belangrijkste punten

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.0 als 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.

Documentatie Voice Agent API

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.

WebSocket
Realtime protocol
grok-voice-3.0
Huidig model
10
Gelijktijdige sessies op het instap-tier
$0,08/min
Prijzen

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:

  1. Verbinding: open de WebSocket met authenticatie
  2. Configuratie: stuur session.update met uw instellingen
  3. Bevestiging: ontvang session.updated van de server
  4. Gesprek: wissel audio- en text-events uit
  5. 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/realtime is 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.created bij verbinding en wacht vervolgens op uw session.update om het gesprek te configureren
  • De prijs is $0,08 per minuut, oftewel $4,80 per uur, plus $0,004 per tekstinput