Salt la conținutul principal
Română— Alege o limbă
Meniu

Conexiunea WebSocket TTS

Lecția 9 din 14 Actualizată 3 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Sinteza vocală în timp real prin WebSocket
  2. Endpoint WebSocket
  3. Deschiderea conexiunii
  4. Gestionarea sesiunii
  5. HTTP unar versus WebSocket
  6. Când să utilizați WebSocket
  7. Puncte cheie

Actualizat la 3 noiembrie 2026, pe baza paginii xAI Text to Speech: delte de până la 60.000 de caractere, fără timeout al conexiunii și un „permis de sesiune“ de 600 de secunde. Sursă: Text to Speech.

Sinteza vocală în timp real prin WebSocket

API-ul Grok TTS oferă un mod WebSocket pentru transmiterea în flux (streaming) a sintezei vocale. Spre deosebire de modul HTTP unar, care așteaptă finalizarea procesării pentru a returna fișierul audio complet, WebSocket trimite fragmente audio pe măsură ce sunt generate. Este ideal pentru aplicațiile interactive unde latența percepută trebuie să fie cât mai redusă posibil.

wss://
Protocol securizat
50
Sesiuni per echipă
600 s
Permis de sesiune
∞
Text nelimitat

Endpoint WebSocket

Vă conectați la wss://api.x.ai/v1/tts. Parametrii de configurare se transmit în șirul de interogare (query string) al conexiunii inițiale.

Parametri de conexiune

ParametruObligatoriuImplicitDescriere
languageDa—Cod BCP-47 sau auto
voiceNu—ID-ul unei voci integrate sau personalizate
codecNump3mp3, wav, pcm, mulaw (sau ulaw), alaw
sample_rateNu24000Frecvența de eșantionare
bit_rateNu128000Rata de biți (doar pentru MP3)

URL complet de conexiune

wss://api.x.ai/v1/tts?language=en&voice=rex&codec=mp3&sample_rate=24000

Deschiderea conexiunii

În JavaScript (browser sau Node.js)

const ws = new WebSocket(
  "wss://api.x.ai/v1/tts?language=en&voice=rex&codec=mp3",
  {
    headers: {
      "Authorization": `Bearer ${API_KEY}`
    }
  }
);

ws.onopen = () => {
  console.log("Conexiune TTS stabilită");
};

ws.onerror = (error) => {
  console.error("Eroare WebSocket:", error);
};

Important: într-un browser, API-ul nativ WebSocket nu suportă antete (headers) personalizate. Va trebui să treceți prin backend-ul dumneavoastră pentru conexiune (consultați lecția despre producție).

În Python cu websockets

import asyncio
import websockets
import json

async def connect_tts():
    uri = "wss://api.x.ai/v1/tts?language=en&voice=rex&codec=mp3"
    headers = {"Authorization": f"Bearer {api_key}"}

    async with websockets.connect(uri, additional_headers=headers) as ws:
        print("Conexiune TTS stabilită")
        # Trimiteți textul și primiți audio...

Gestionarea sesiunii

Durata de viață

Pagina xAI Text to Speech menționează două aspecte pe care trebuie să le analizați împreună: conexiunea WebSocket nu are un timeout pentru cereri (rămâne deschisă), iar „permisul de sesiune“ are o durată de viață de 600 de secunde, fără ca pagina să explice ce se întâmplă la expirarea acestuia. Pentru siguranță, aplicația dumneavoastră ar trebui să:

  1. Detecteze când se închide conexiunea
  2. Se reconecteze automat dacă este necesar
  3. Reia trimiterea textului de unde a rămas

Sesiuni concurente

Conform paginii Text to Speech, echipa dumneavoastră este limitată la 50 de sesiuni WebSocket concurente (pagina Rate limits numără sesiunile TTS pe niveluri, începând de la 100). Dincolo de această limită, noile conexiuni sunt refuzate. Gestionați un pool de conexiuni pentru aplicațiile cu trafic ridicat.

Mai multe texte pe o singură conexiune

Spre deosebire de modul HTTP unar, unde cererile expiră după 15 minute, conexiunea rămâne deschisă după fiecare audio.done: puteți trimite un text după altul fără a vă reconecta și puteți anula textul curent cu text.clear (lecția 10).

HTTP unar versus WebSocket

AspectHTTP unarWebSocket
LatențăAudio complet după procesarePrimii octeți imediat
Text maxim60.000 de caractere per cerereNelimitat (delte de max. 60.000)
Timeout15 minuteNiciunul; permis de sesiune de 600 de secunde
SesiuniN/A50 per echipă
Cazuri de utilizareLoturi, fișiere audioTimp real, streaming

Când să utilizați WebSocket

WebSocket este soluția recomandată de îndată ce este implicat timpul real. Când un utilizator așteaptă un răspuns vocal imediat, de la un chatbot sau un asistent vocal, fiecare secundă de liniște înainte de primul sunet vă costă în ceea ce privește experiența percepută, iar WebSocket permite începerea redării la primele fragmente audio, înainte chiar ca generarea să se fi încheiat. Este, de asemenea, arhitectura naturală atunci când textul însuși sosește treptat: ieșirea în flux a unui LLM se conectează direct la TTS, deltă cu deltă, fără a aștepta textul complet. Și elimină constrângerea de lungime: nu există o limită globală asupra textului total, doar deltele individuale sunt limitate la 60.000 de caractere, suficient pentru a vocaliza un document întreg ca un flux continuu.

Modul HTTP unar își păstrează utilitatea oriunde timpul real nu aduce niciun avantaj: generarea de fișiere audio în loturi, procese care necesită fișierul complet înainte de a acționa (post-procesare, stocare, trimitere) și, mai simplu, orice arhitectură care preferă o interacțiune stateless în detrimentul gestionării unei conexiuni persistente.

Puncte cheie

  • TTS WebSocket este disponibil la wss://api.x.ai/v1/tts
  • Parametrii se transmit în șirul de interogare la conectare
  • Conexiunea nu expiră de la sine, dar documentația menționează un permis de sesiune de 600 de secunde: planificați reconectarea
  • Limita este de 50 de sesiuni concurente per echipă
  • Textul este nelimitat (trimis în delte de până la 60.000 de caractere)
  • Utilizați WebSocket pentru timp real, HTTP pentru loturi