Открыть оглавление

Подключение

Отправьте POST с конфигурацией потока и получите URL узла, идентификатор сессии и токен.

Запрос

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?Второй проход по каждому переводу. См. ИИ-доработка перевода.
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).