瀏覽文件目錄

連線

POST 串流的設定,拿回節點 URL、工作階段 ID 和 token。

請求

bash
curl -X POST https://api.lecsync.com/v1/realtime/connect \  -H "Authorization: Bearer lk_live_xxxxxxxx" \  -H "Content-Type: application/json" \  -d '{    "region": "us",    "audio":      { "encoding": "pcm_s16le", "sampleRate": 16000, "channels": 1 },    "transcribe": { "languages": ["en"], "strict": true, "speakers": false,                    "identifyLanguage": false, "displayMode": "sentence", "segmentation": "balanced" },    "translate":  { "languages": ["en", "zh"] },    "glossary":   { "terms": ["LecSync", "PyTorch"],                    "pairs": [{ "source": "LecSync", "target": "录同步" }],                    "context": "University computer science lecture" },    "store": true  }'

請求欄位

欄位類型說明
regionstring?us | uk | jp | ru。不傳時按請求來源國家,就近選擇仍有容量的區;來源國家未知時按 us、uk、jp、ru 依序嘗試。指定了就只用該區,該區沒有可路由槽回 503,不會改去別的區。
audio.encodingstringpcm_s16le,v1 唯一取值。
audio.sampleRatenumber16000.
audio.channelsnumber1(單聲道)。
transcribeobject語言提示與分句。見轉錄、說話人。
translateobject?語言對。見翻譯。不傳則不翻譯。
glossaryobject?術語與強制譯法。見術語表。
aiEnhanceboolean?對每條譯文做第二輪精修。見 AI 譯文優化。
digestboolean?會話進行中推送紀要。見即時紀要。
storeboolean?預設 false(不持久化音訊和轉錄);傳 true 時保存音訊與轉錄 30 天。見錄音。

回應

json
{  "url": "wss://gw-us-a.lecsync.com/v1/sessions/cmxxxxxxxxxxxxxx",  "sessionId": "cmxxxxxxxxxxxxxx",  "token": "eyJhbGciOiJIUzI1NiJ9...",  "expiresAt": "2026-09-16T12:00:00Z",  "protocolVersion": 1,  "audio": {    "encoding": "pcm_s16le",    "sampleRate": 16000,    "channels": 1,    "maxFrameBytes": 65536  }}

回應欄位

欄位類型說明
urlstring這條串流的 WebSocket 位址。按區域、按串流簽發,不要快取。
sessionIdstring標識這條串流;store 為 true 時也是錄音的鍵。
tokenstring開啟 WebSocket 的一次性憑證。
expiresAtstring建立連線的截止時間(ISO 8601),不是連線能開多久。
protocolVersionnumber1.
audioobject接受的音訊格式,含 maxFrameBytes(65536)。