Skip to main content

Ikhtisar

Endpoint ini digunakan untuk pengenalan suara, sintesis suara, terjemahan suara, atau model multimodal realtime. Permintaan GET 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 metadata GET /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 kirim model 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.