浏览文档目录

连接

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)。