用途:在本地构建 AssemblyAI 集成的确定性开发循环,用合成夹具、录制的契约以及可选的有界真实调用通道进行验证,适用于不希望暴露音频或转录内容的开发场景。
主要能力:夹具可模拟 REST 任务状态、Streaming v3 消息、两类 webhook、LLM Gateway 输出、限流、重复事件与终止;支持注入假时钟、确定性抖动与有界队列;覆盖延迟轮询、429、重复、畸形事件与断连等情形。
使用方式:先梳理实际使用的适配器接口,创建合成音频与无内容响应夹具,将真实测试置于独立开关与密钥上下文之后,并对照第一方最新 schema 审查录制契约差异。真实调用时从已批准的密钥管理器注入 ASSEMBLYAI_API_KEY,仅在 AssemblyAI Authorization 头中发送原始值至配置的第一方主机,不得打印、提交、放入 URL 或暴露给不可信客户端;回调密钥与临时流式令牌属于独立凭据。
限制:普通开发保持离线;公网隧道与真实 API 调用属于显式暴露与成本边界。涉及真实音频处理、生产凭据或端点变更、付费模型或容量变更、内容留存、回调重放、部署或删除,均需有责任负责人批准。默认测试若依赖真实密钥则不具备确定性,真实转录文本不得进入黄金夹具。输出应包含操作范围、环境、区域、契约面、授权类别、确定性验证结果、无内容标识符、风险与清理状态,并排除凭据、签名 URL、音频、转录文本与客户衍生内容。具体模型、参数、限额、价格、区域与生命周期声明暂未提供。