Langsung ke konten utama

​
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.
Agent sebaiknya menemukan model yang mendukung realtime melalui /v1/models sebelum membuka socket.

​
Koneksi

​
model
string
wajib
ID model realtime. Gunakan model yang kontrak publiknya mencantumkan dukungan realtime.
​
Authorization
string
wajib
API key Bearer. Client WebSocket harus mengirim Authorization: Bearer sk-your-api-key saat upgrade request.
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());
});

​
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.