Skip to main content

概覽

此端點用於即時語音辨識、語音合成、語音翻譯或即時多模態模型等會話。一般 GET 請求會回傳端點資訊;WebSocket 升級請求會代理到路由後的即時上游會話。

支援範圍

此端點是 TokenLab 的即時 WebSocket 代理。它支援一般 GET /v1/realtime 端點資訊檢查,也支援在同一路徑發起 WebSocket 升級。它不提供 OpenAI Realtime 的 REST 輔助端點,例如 POST /v1/realtime/client_secretsPOST /v1/realtime/translations/client_secrets、Realtime Calls(accepthangupreferreject),也不提供 legacy beta REST session / transcription-session 建立。 瀏覽器或行動端應把長期 API Key 保留在服務端。此端點不會簽發短期 Realtime client secret。
Agent 應先透過 /v1/models 找到支援 realtime 的模型,再開啟 socket。

連線

string
必填
即時模型 ID。請選擇対応状況中包含 realtime 支援的模型。
string
必填
Bearer API Key。WebSocket 用戶端應在升級請求中傳送 Authorization: Bearer sk-your-api-key

訊息

TokenLab 會在用戶端與路由後的即時提供方之間轉發 WebSocket 訊息。請保留所選模型的官方事件格式,並透過查詢參數傳入 model

計費與關閉

即時會話使用同一 API Key 餘額。TokenLab 會在 socket 開啟時預扣小額估算費用,並在會話關閉時計費或退款。 會話完成後關閉用戶端 socket。若上游先關閉,TokenLab 會盡可能把關閉碼轉發給用戶端。

回應範例

重要欄位

string
API 返回的事件或訊息類型。
string
即時提供方回傳的標識符;可用於日誌和支援排障,不是 REST session URL。