Chuyển đến nội dung chính

​
Tổng quan

Endpoint này dùng cho nhận dạng giọng nói, tổng hợp giọng nói, dịch giọng nói hoặc mô hình đa phương thức thời gian thực. Yêu cầu GET thường trả về metadata; yêu cầu upgrade WebSocket sẽ được proxy tới phiên upstream đã định tuyến.
Agent nên dùng /v1/models để tìm mô hình hỗ trợ realtime trước khi mở socket.

​
Kết nối

​
model
string
bắt buộc
ID mô hình realtime. Chọn mô hình có hợp đồng công khai liệt kê hỗ trợ realtime.
​
Authorization
string
bắt buộc
API key Bearer. Client WebSocket nên gửi Authorization: Bearer sk-your-api-key trong yêu cầu upgrade.
import WebSocket from 'ws';

const socket = new WebSocket('wss://api.tokenlab.sh/v1/realtime?model=qwen-tts-realtime', {
  headers: { Authorization: 'Bearer sk-your-api-key' }
});

socket.on('open', () => {
  socket.send(JSON.stringify({ type: 'session.start' }));
});

socket.on('message', (data) => {
  console.log('realtime event', data.toString());
});

​
Tin nhắn

TokenLab chuyển tiếp tin nhắn WebSocket giữa client và nhà cung cấp realtime đã định tuyến. Giữ đúng dạng sự kiện chính thức của mô hình đã chọn và truyền model trong query string.

​
Tính phí và đóng kết nối

Phiên realtime dùng cùng số dư API key. TokenLab trừ trước một ước tính nhỏ khi socket mở, rồi quyết toán hoặc hoàn tiền khi phiên đóng. Đóng socket client khi phiên hoàn tất. Nếu upstream đóng trước, TokenLab sẽ chuyển tiếp close code khi có thể.