Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

L-endpoint WebSocket u l-konnessjoni f'ħin reali

Lezzjoni 1 / 16 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. L-API tal-Aġent Vokali f’Ħin Reali
  2. Iftaħ il-konnessjoni WebSocket
  3. Iċ-ċiklu tal-ħajja tas-sessjoni
  4. Punti Ewlenin

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.0 bħ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.

Dokumentazzjoni tal-API tal-Aġent Vokali

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.

WebSocket
Protokoll f'ħin reali
grok-voice-3.0
Mudell kurrenti
10
Sessjonijiet konkorrenti fil-livell tad-dħul
$0.08/min
Prezzijiet

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:

  1. Konnessjoni: iftaħ il-WebSocket bl-awtentikazzjoni
  2. Konfigurazzjoni: ibgħat session.update bis-settings tiegħek
  3. Konferma: irċievi session.updated mis-server
  4. Konversazzjoni: skambja avvenimenti tal-awdjo u tat-test
  5. 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/realtime huwa 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.created mal-konnessjoni, imbagħad jistenna l-session.update tiegħ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