Ikhtisar
Endpoint ini digunakan untuk pengenalan suara, sintesis suara, terjemahan suara, atau model multimodal realtime. PermintaanGET biasa mengembalikan metadata; upgrade WebSocket diproksikan ke sesi upstream realtime yang dirutekan.
Permukaan yang didukung
Endpoint ini adalah proxy WebSocket realtime TokenLab. Endpoint ini mendukung pengecekan metadataGET /v1/realtime biasa dan upgrade WebSocket pada path yang sama. Endpoint ini tidak menyediakan endpoint helper REST OpenAI Realtime seperti POST /v1/realtime/client_secrets, POST /v1/realtime/translations/client_secrets, Realtime Calls (accept, hangup, refer, reject), atau pembuatan legacy beta REST session / transcription-session.
Untuk aplikasi browser atau mobile, simpan API key jangka panjang di server Anda. Endpoint ini tidak menerbitkan Realtime client secret berumur pendek.
Agent sebaiknya menemukan model yang mendukung realtime melalui
/v1/models sebelum membuka socket.Koneksi
string
wajib
ID model realtime. Gunakan model yang detail modelnya mencantumkan dukungan realtime.
string
wajib
API key Bearer. Client WebSocket harus mengirim
Authorization: Bearer sk-your-api-key saat upgrade request.Pesan
TokenLab meneruskan pesan WebSocket antara client dan penyedia realtime yang dirutekan. Pertahankan bentuk event resmi model yang dipilih dan kirimmodel di query string.
Penagihan dan penutupan
Sesi realtime memakai saldo API key yang sama. TokenLab melakukan pre-deduct kecil saat socket dibuka, lalu melakukan settlement atau refund saat sesi ditutup. Tutup socket client saat sesi selesai. Jika upstream menutup lebih dulu, TokenLab meneruskan close code bila memungkinkan.Contoh respons
Field penting
string
Tipe event atau message yang dikembalikan API.
string
Identifier yang dikirim provider realtime; sertakan di log dukungan, bukan sebagai REST session URL.