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.aisonar.dev/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

AI Sonar 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. AI Sonar 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, AI Sonar meneruskan close code bila memungkinkan.