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ầuGET thường trả về metadata; yêu cầu upgrade WebSocket sẽ được proxy tới phiên upstream đã định tuyến.
Phạm vi hỗ trợ
Endpoint này là proxy WebSocket thời gian thực của TokenLab. Nó hỗ trợ kiểm tra metadata bằngGET /v1/realtime và upgrade WebSocket trên cùng đường dẫn. Nó không cung cấp các REST helper endpoint của OpenAI Realtime như POST /v1/realtime/client_secrets, POST /v1/realtime/translations/client_secrets, Realtime Calls (accept, hangup, refer, reject) hoặc tạo legacy beta REST session / transcription-session.
Với ứng dụng trình duyệt hoặc di động, hãy giữ API key dài hạn trên server của bạn. Endpoint này không phát hành Realtime client secret ngắn hạ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
string
bắt buộc
ID mô hình realtime. Chọn mô hình có chi tiết model liệt kê hỗ trợ realtime.
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.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ềnmodel 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ể.Ví dụ phản hồi
Trường quan trọng
string
Loại event hoặc message do API trả về.
string
Mã định danh do provider realtime trả về; dùng trong log hỗ trợ, không phải REST session URL.