用途:Zoom AI Services Scribe 为参考技能,用于将已上传或已存储的媒体转写为文本。路由规则:需要上传或存储媒体转写时先路由本技能;需要无文件上传的实时会议媒体时路由 rtms;需要 Zoom REST API 的 AI Services 路径清单时链 rest-api;需要 webhook 签名模式或通用 HMAC 接收端加固时可选链 webhooks。
主要能力:同步单文件转写(POST /aiservices/scribe/transcribe);异步批处理作业(POST /aiservices/scribe/jobs、GET 列表、GET /jobs/{jobId} 查看、DELETE 取消、GET /jobs/{jobId}/files 查看逐文件结果);webhook 驱动的批处理状态更新;通过重复短文件上传实现的浏览器麦克风伪流式;Build 平台 JWT 生成与凭据处理。核心流程:获取凭据并生成 HS256 JWT;短文件用 fast 模式,存储归档或大批量用 batch 模式;提交请求;批处理轮询状态或接收 webhook;持久化并后处理 transcript JSON。
限制与注意:fast 模式正式限制 100 MB、2 小时,但托管浏览器流程可能提前超时;前端 504 而后端 200 属浏览器/边缘超时竞争,不代表转写失败;托管 UI 建议对 fast 模式用异步请求/轮询包装,较大或不可预测媒体优先用 batch。scribe 无文档化实时流式 API;浏览器麦克风用伪流式(建议 5 秒分块、可接受 5-10 秒、并发 2-3 个分块请求),仅为回退演示模式,非生产首选,存在上传开销、分块边界漂移与拼接复杂度;真正实时流式应路由 rtms。文档、代码与快速开始见 https://developers.zoom.us/docs/ai-services/scribe/ 与 https://github.com/zoom/scribe-quickstart/。