🎙️ Realtime API

POST https://platform.beeknoee.com/v1/realtime/sessions

{
  "id": "bee_rt_8Kq2mZ1vN4xPwTcR7hJdLs0y",
  "object": "realtime.session",
  "status": "created",
  "model": "gpt-realtime-2.1-mini",
  "engine_protocol": "openai-realtime-v1",
  "transport": "webrtc",
  "billing_basis": "token",
  "connect_by": "2026-09-18T10:31:00.000Z",
  "connection": {
    "type": "webrtc",
    "sdp_url": "https://platform.beeknoee.com/v1/realtime/sessions/bee_rt_8Kq2mZ1vN4xPwTcR7hJdLs0y/sdp",
    "data_channel": "oai-events",
    "token": "bee_rts_9f3c...",
    "token_expires_at": "2026-09-18T10:31:00.000Z"
  },
  "billing": {
    "currency": "VND",
    "settle_interval_sec": 60,
    "estimated_vnd_per_min": 1030,
    "max_spend_vnd": 50000
  }
}

const pc = new RTCPeerConnection()

// Loa: gắn luồng âm thanh của model vào thẻ <audio>
pc.ontrack = (e) => { document.querySelector('audio').srcObject = e.streams[0] }

// Micro
const mic = await navigator.mediaDevices.getUserMedia({ audio: true })
pc.addTrack(mic.getTracks()[0])

// Kênh sự kiện của model (tên kênh nằm ở connection.data_channel)
const events = pc.createDataChannel(session.connection.data_channel)
events.onmessage = (e) => console.log(JSON.parse(e.data))

const offer = await pc.createOffer()
await pc.setLocalDescription(offer)

const answer = await fetch(session.connection.sdp_url, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${session.connection.token}`,
    'Content-Type': 'application/sdp',
  },
  body: offer.sdp,
}).then((r) => r.text())

await pc.setRemoteDescription({ type: 'answer', sdp: answer })

const ws = new WebSocket(session.connection.url)

ws.onmessage = (e) => {
  const msg = JSON.parse(e.data)
  if (msg.bee) return console.log('Beeknoee:', msg.bee)   // sự kiện của Beeknoee (tiền, phiên)
  console.log('model:', msg)                              // sự kiện của model (khuôn theo connection.protocol)
}

// Gửi âm thanh: PCM16 16 kHz, mã hoá base64 — khuôn message theo connection.protocol
if (session.connection.protocol === 'gemini-live-v1beta') {
  ws.send(JSON.stringify({ realtimeInput: { audio: { mimeType: 'audio/pcm;rate=16000', data: base64Pcm } } }))
} else {
  ws.send(JSON.stringify({ type: 'input_audio_buffer.append', audio: base64Pcm }))
}

GET https://platform.beeknoee.com/v1/realtime/sessions/{id}/events

# Kết thúc phiên (chốt sổ rồi đóng kênh tiếng)
curl -X DELETE https://platform.beeknoee.com/v1/realtime/sessions/{id} \
  -H "Authorization: Bearer $BEEKNOEE_API_KEY"

# Xem một phiên
curl https://platform.beeknoee.com/v1/realtime/sessions/{id} \
  -H "Authorization: Bearer $BEEKNOEE_API_KEY"

# Lịch sử phiên
curl https://platform.beeknoee.com/v1/realtime/sessions?limit=20 \
  -H "Authorization: Bearer $BEEKNOEE_API_KEY"

# Danh mục model realtime kèm giá theo gói của bạn
curl https://platform.beeknoee.com/v1/realtime/models \
  -H "Authorization: Bearer $BEEKNOEE_API_KEY"

curl -X POST https://platform.beeknoee.com/v1/realtime/sessions \
  -H "Authorization: Bearer sk-bee-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-realtime-2.1-mini",
    "instructions": "You are a concise customer-support assistant. Answer in the caller'"'"'s language.",
    "max_spend_vnd": 20000
  }'

import requests

BEE = "https://platform.beeknoee.com/v1"
HEADERS = {"Authorization": "Bearer sk-bee-your-key"}

# Máy chủ giữ API key; trình duyệt chỉ nhận `connection` (token phiên 60 giây, dùng một lần)
session = requests.post(f"{BEE}/realtime/sessions", headers=HEADERS, json={
    "model": "gpt-realtime-2.1-mini",
    "instructions": "You are a concise customer-support assistant. Answer in the caller's language.",
    "max_spend_vnd": 20000,
}).json()

print(session["id"], session["connection"]["type"])
# → gửi session["connection"] cho trình duyệt (xem Bước 2). KHÔNG gửi API key.

// Máy chủ (Node 18+): tạo phiên, chỉ trả `id` + `connection` cho trình duyệt
const res = await fetch('https://platform.beeknoee.com/v1/realtime/sessions', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer sk-bee-your-key', 'Content-Type': 'application/json' },
  body: JSON.stringify({ model: 'gpt-realtime-2.1-mini', max_duration_sec: 600 }),
})
const session = await res.json()
// trả cho trình duyệt: { id: session.id, connection: session.connection }

// Máy chủ tạo phiên Gemini — nhận connection.type = "websocket", protocol = "gemini-live-v1beta"
const res = await fetch('https://platform.beeknoee.com/v1/realtime/sessions', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer sk-bee-your-key', 'Content-Type': 'application/json' },
  body: JSON.stringify({ model: 'gemini-3.8-live', instructions: 'You are a friendly language tutor.' }),
})
const session = await res.json()

// Trình duyệt mở WebSocket; KHÔNG gửi setup — phiên đã được cấu hình xong ở Bước 1
const ws = new WebSocket(session.connection.url)
ws.onmessage = (e) => {
  const msg = JSON.parse(e.data)
  if (msg.bee) return console.log('Beeknoee:', msg.bee)
  const part = msg.serverContent?.modelTurn?.parts?.[0]
  if (part?.inlineData) playPcm24k(part.inlineData.data)        // tiếng của model: PCM16 24 kHz, base64
}
ws.onopen = () => ws.send(JSON.stringify({ realtimeInput: { audio: { mimeType: 'audio/pcm;rate=16000', data: base64Pcm } } }))

# Dòng sự kiện của Beeknoee cho một phiên (usage.settled, warning.low_balance, session.ended…)
curl -N https://platform.beeknoee.com/v1/realtime/sessions/bee_rt_xxx/events \
  -H "Authorization: Bearer sk-bee-your-key"