Spring til hovedindhold
Dansk— Vælg et sprog
Menu

WebSocket-endepunktet og realtidsforbindelsen

Lektion 1 af 16 Opdateret 3. november 2026 Udvikler
På denne side
  1. Voice Agent API i realtid
  2. Åbn WebSocket-forbindelsen
  3. Sessionens livscyklus
  4. Vigtige pointer

Opdateret 3. november 2026 baseret på xAI-siderne Speech to Speech, Pricing og Rate limits: 0,08 USD pr. minut, samtidige sessioner efter niveau og grok-voice-3.0 som den aktuelle model. Kilder: Speech to Speech · Pricing · Rate limits.

Voice Agent API i realtid

Grok Voice Agent API giver dig mulighed for at bygge konversationelle taleagenter, der taler med dine brugere i realtid. I modsætning til klassiske REST-API’er, der arbejder anmodning for anmodning, bruger dette API WebSocket-protokollen til at holde en vedvarende tovejsforbindelse åben mellem din app og xAI’s servere.

Dokumentation for Voice Agent API

Der er kun ét endepunkt:

wss://api.x.ai/v1/realtime

Du vælger modellen med URL-parameteren model, for eksempel wss://api.x.ai/v1/realtime?model=grok-voice-latest. grok-voice-latest peger på grok-voice-3.0, som er den aktuelle model, og det er også standarden. I produktion anbefaler xAI, at du låser en navngiven version fast.

Dette ene endepunkt håndterer hele livscyklussen for en talesamtale: modtagelse af lyd, detektering af tale, generering af svar og tilbagesendelse af den syntetiserede lyd.

WebSocket
Realtidsprotokol
grok-voice-3.0
Aktuel model
10
Samtidige sessioner på startniveauet
0,08 USD/min
Prissætning

Åbn WebSocket-forbindelsen

For at oprette forbindelsen skal du placere din xAI API-nøgle i autorisationsheadere. Her er et eksempel 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 Python kan du bruge biblioteket 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())

Sessionens livscyklus

Så snart WebSocket-forbindelsen åbnes, sender serveren en session.created-begivenhed, der bekræfter, at sessionen er aktiv. Derefter sender du en session.update-begivenhed for at konfigurere samtalen (stemme, instrukser, værktøjer, tur-detektering).

Den typiske cyklus ser sådan ud:

  1. Forbindelse: Åbn WebSocket med autentificering
  2. Konfiguration: Send session.update med dine indstillinger
  3. Bekræftelse: Modtag session.updated fra serveren
  4. Samtale: Udveksling af lyd- og tekstbegivenheder
  5. Lukning: Afbryd WebSocket-forbindelsen korrekt

Håndtering af forbindelsesfejl

Serveren kan lukke eller nægte forbindelsen af flere årsager: en autentificeringsfejl, overskridelse af grænsen for samtidige sessioner for dit niveau (10 på startniveauet, op til 200 på det højeste) eller en hændelse. Den aktuelle dokumentation angiver ingen maksimal sessionslængde, og genoptagelse af session (lektion 4) giver dig mulighed for at genoptage en samtale efter et afbrud. Din app bør inkludere genforbindelseslogik med eksponentiel backoff.

Priser tjekket 3. november 2026. Priser ændres ofte: Før du lægger et budget, bør du tjekke de aktuelle satser på xAI’s officielle prisside.

Vigtige pointer

  • WebSocket-endepunktet wss://api.x.ai/v1/realtime er det eneste indgangspunkt for alle talesamtaler
  • Du autentificerer med headeren Authorization: Bearer {API-nøgle}
  • Antallet af samtidige sessioner afhænger af dit niveau: 10 på startniveauet, op til 200
  • Serveren sender session.created ved forbindelse og venter derefter på din session.update for at konfigurere samtalen
  • Prisen er 0,08 USD pr. minut eller 4,80 USD i timen, plus 0,004 USD pr. tekstinput