Управление на сесиите в WebSocket
На тази страница
Обновено на 3 ноември 2026 г., въз основа на страницата Text to Speech на xAI, която споменава 600-секундно “разрешение за сесия” и връзка без таймаут. Стратегията за подновяване по-долу е предпазна мярка. Източник: Text to Speech.
Овладяване на жизнения цикъл на сесията
В производствена среда надеждното управление на сесиите в WebSocket е това, което отличава прототипа от надежден продукт. Сесиите за TTS имат специфични ограничения (продължителност на живота, лимити за едновременност), които Вашето приложение трябва да обработва правилно.
Жизнен цикъл на сесията
Една WebSocket сесия за TTS преминава през следния цикъл:
- Отваряне: свързване към
wss://api.x.ai/v1/ttsс параметрите - Активна: размяна на съобщения
text.delta/audio.delta - Нормално затваряне: клиентът или сървърът затварят връзката
- Неочаквано затваряне: грешка, техническо обслужване или изтичане на 600-секундното разрешение за сесия, споменато в документацията
Откриване на затваряне
Сървърът може да затвори връзката по всяко време (вътрешна грешка, техническо обслужване, край на разрешението за сесия). Вашето приложение винаги трябва да обработва събитието за затваряне:
async def managed_session(api_key, language="en", voice="eve"):
uri = f"wss://api.x.ai/v1/tts?language={language}&voice={voice}"
headers = {"Authorization": f"Bearer {api_key}"}
try:
async with websockets.connect(uri, additional_headers=headers) as ws:
yield ws
except websockets.ConnectionClosed as e:
print(f"Connection closed: code={e.code}, reason={e.reason}")
except websockets.ConnectionClosedError:
print("Connection lost unexpectedly")
Автоматично повторно свързване
За приложения с дълъг период на работа внедрете повторно свързване с експоненциално забавяне (exponential backoff):
import asyncio
import random
class TTSSessionManager:
def __init__(self, api_key, language="en", voice="eve"):
self.api_key = api_key
self.language = language
self.voice = voice
self.ws = None
self.max_retries = 5
async def connect(self):
uri = f"wss://api.x.ai/v1/tts?language={self.language}&voice={self.voice}"
headers = {"Authorization": f"Bearer {self.api_key}"}
for attempt in range(self.max_retries):
try:
self.ws = await websockets.connect(uri, additional_headers=headers)
print(f"Connected (attempt {attempt + 1})")
return
except Exception as e:
wait = min(2 ** attempt + random.random(), 30)
print(f"Connection failed: {e}. Retrying in {wait:.1f}s")
await asyncio.sleep(wait)
raise ConnectionError("Could not connect after 5 attempts")
async def ensure_connected(self):
if self.ws is None or self.ws.closed:
await self.connect()
async def synthesize(self, text):
await self.ensure_connected()
try:
await self.ws.send(json.dumps({
"type": "text.delta",
"delta": text
}))
await self.ws.send(json.dumps({"type": "text.done"}))
audio_chunks = []
async for msg in self.ws:
data = json.loads(msg)
if data["type"] == "audio.delta":
audio_chunks.append(base64.b64decode(data["delta"]))
elif data["type"] == "audio.done":
break
elif data["type"] == "error":
raise Exception(data["message"])
return b"".join(audio_chunks)
except websockets.ConnectionClosed:
# Повторно свързване и повторен опит
await self.connect()
return await self.synthesize(text)
Управление на продължителността на сесията
Страницата Text to Speech на xAI споменава 600-секундно “разрешение за сесия”, без да уточнява кога започва то или какво се случва при изтичането му, и отделно посочва, че връзката няма таймаут. Най-предпазливият подход е да броите от момента на свързване и да подновите сесията преди тази точка:
import time
class TTLAwareSession:
TTL = 600 # секунди
REFRESH_MARGIN = 60 # повторно свързване 60 сек преди изтичане
def __init__(self):
self.connected_at = None
async def connect(self):
# ... свързване ...
self.connected_at = time.time()
def should_refresh(self):
if self.connected_at is None:
return True
elapsed = time.time() - self.connected_at
return elapsed >= (self.TTL - self.REFRESH_MARGIN)
async def synthesize(self, text):
if self.should_refresh():
await self.connect() # Нова сесия
# ... изпращане на текста ...
Повторното свързване 60 секунди преди изтичането Ви предпазва от прекъсване по средата на синтеза.
Пул от сесии
За приложения с висок трафик поддържайте пул от многократно използваеми сесии:
class SessionPool:
def __init__(self, api_key, pool_size=10):
self.api_key = api_key
self.pool_size = min(pool_size, 50) # Максимум 50 на екип
self.available = asyncio.Queue()
self.active_count = 0
async def acquire(self):
if not self.available.empty():
session = await self.available.get()
if not session.should_refresh():
return session
if self.active_count < self.pool_size:
session = TTSSessionManager(self.api_key)
await session.connect()
self.active_count += 1
return session
# Изчакване за освобождаване на сесия
return await self.available.get()
async def release(self, session):
await self.available.put(session)
Поддържайте размера на пула като част от лимита от 50 сесии, за да оставите резерв за другите услуги на Вашето приложение.
Метрики за наблюдение
За да поддържате сесиите здрави в производствена среда, наблюдавайте:
- Брой активни сесии: не трябва да надвишава 50
- Честота на повторните свързвания: висока честота сочи към мрежов проблем или проблем с продължителността на живота
- Латентност на първия audio.delta: измерва колко бързо реагира услугата
- Грешки в WebSocket: необичайни кодове за затваряне (1006, 1011)
class MetricsCollector:
def __init__(self):
self.connections = 0
self.reconnections = 0
self.errors = 0
self.first_audio_latencies = []
def record_connection(self):
self.connections += 1
def record_reconnection(self):
self.reconnections += 1
def record_first_audio(self, latency_ms):
self.first_audio_latencies.append(latency_ms)
Ключови изводи
- Документацията споменава 600-секундно разрешение за сесия: за сигурност го броете от момента на свързване
- Внедрете автоматично повторно свързване с експоненциално забавяне
- Подновете сесията преди тази точка (с марж от 60 секунди)
- Използвайте пул от сесии за приложения с висок трафик
- Спазвайте лимита от 50 едновременни сесии на екип
- Наблюдавайте метриките за връзката в производствена среда