SuperAPI AI 工具集

assemblyai-webhooks-events

安全与审计

查看项目

更新于 10-16 06:20

技能介绍

用途:以“可认证、可重复投递”的方式处理 AssemblyAI 的预录音频与流式回调,将确认、内容获取、持久化、重放、凭据与删除分开治理。

主要能力:区分预录回调(携带 transcript ID 与状态,需另行获取完整转写)与流式回调(终止后可能携带已定稿回合);按事件 schema 绑定路由;解析前捕获有限原始字节并验证认证头;校验内容类型与字段白名单;按事件族与稳定标识生成持久去重键;持久化最小化数据后在时限内返回 2xx;按 ID 获取预录结果并隔离 schema 漂移。

必要用法:确认目标仓库或集成路径与运维目标;明确 AssemblyAI 项目、环境、区域、数据分级与责任人;仅依据当前第一方文档,凭据只用于范围明确的实时检查。实时操作时从批准的密钥管理器注入 ASSEMBLYAI_API_KEY,仅在发往已配置第一方主机的 Authorization 头中发送原始值,禁止打印、提交、放入 URL 或暴露给不可信客户端。回调密钥与临时流式令牌属独立凭据。

限制:AssemblyAI 记录 10 秒确认窗口,未收到 2xx 时最多重试 10 次,4xx 会停止重试;瞬时 4xx 可能导致永久丢失。IP 白名单只是补充,不能替代回调认证。重复投递不得触发重复下游动作。调用本技能本身不授权调用 AssemblyAI、上传音频、开启流式会话、生成令牌、重放回调、部署、轮换密钥或删除转写。实时音频处理、生产凭据或端点变更、付费模型或容量变更、内容留存、回调重放、部署与删除均需责任人批准。输出应包含操作范围、环境、区域、契约界面、授权类别、确定性验证结果、无内容标识、风险与清理回滚状态,排除凭据、签名 URL、音频、转写文本、提示词与客户派生内容。