接入概览
leelaa Audio TXT 只处理调用方明确授权的本地文件或 HTTP(S) 音频地址。不解析第三方站点，不绕过 DRM，也不把字幕写回媒体目录。
机器可读契约：OpenAPI（构建产物里还有 /openapi.yaml）。
调用前准备
bash
export SERVICE_URL='http://127.0.0.1:8687'
export AUDIO_TXT_API_KEY='lat_live_...'- 与服务共享宿主机网络的后端默认用
http://127.0.0.1:8687。通过 fnOS 网关调用时，从管理台复制完整服务地址，保留/app/leelaa-audio-txt前缀，例如https://nas.example.com/app/leelaa-audio-txt。独立容器里的127.0.0.1指向容器自身。 - 请求头是
X-API-Key。 - 先打健康检查，再确认管理台里识别模型已激活。
推荐流程
- 启动时读取服务地址和 Key，调用
/api/health。 - 使用业务 Key 探测
/api/capabilities。支持源复用时登记/api/sources，以流上传原文件一次，再为各区间创建任务；默认上传，只有显式目录映射才登记共享文件。旧服务退回 multipart。 - 持久保存源
id、任务id与源版本；整书期间续租，结束或取消释放源。保存任务返回的id，每 5–10 秒GET /api/jobs/{id}，用progress展示 0–100。 - 遇到
awaiting_confirmation时让用户选复用或重跑；其他终态停止轮询。 ready后请求/result，响应正文就是字幕。
两个调用方
| 调用方 | mode | 推荐 formats | 主要结果 |
|---|---|---|---|
leelaa-reader | audiobook | vtt, lrc, json | LRC 驱动逐句滚动，WebVTT 兜底 |
leelaa-3dvr | movie | vtt, json | WebVTT 作字幕轨，JSON 给自定义时间轴 |
language 推荐 auto。只在需要翻译时传 targetLanguage。