Skip to main content

Ikhtisar

Gunakan endpoint ini untuk sesi real-time seperti pengenalan ucapan streaming, sintesis ucapan, terjemahan ucapan, atau model multimodal real-time. Permintaan GET biasa mengembalikan metadata endpoint, sedangkan permintaan upgrade WebSocket membuka sesi real-time untuk model yang dipilih.

Permukaan yang didukung

TokenLab menyediakan endpoint WebSocket realtime di GET /v1/realtime untuk pengecekan metadata dan upgrade WebSocket. Anggap endpoint ini sebagai WebSocket subset: endpoint meneruskan event model realtime yang didukung dan tidak mendukung permukaan helper REST OpenAI Realtime seperti pembuatan sesi, client_secrets, API kontrol panggilan Calls, atau legacy beta session APIs. 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 klien Anda dan model real-time yang dipilih. Gunakan format event yang didokumentasikan untuk model tersebut, dan sertakan model di query string alih-alih di setiap event.

Penagihan dan penutupan

Sesi ditagih dari saldo kunci API Anda: TokenLab mencadangkan estimasi di awal, lalu menyelesaikan penggunaan sebenarnya di akhir dan mengembalikan selisihnya. Tutup socket klien saat sesi selesai. Jika layanan menutup sesi terlebih dahulu, TokenLab mengirimkan event/kode penutupan yang aman ke klien Anda jika memungkinkan.

Contoh respons

Field penting

string
Tipe event atau message yang dikembalikan API.
string
Identifier opak yang diterima melalui koneksi realtime. Sertakan di log dukungan untuk debugging; ini bukan REST session URL.