SuperAPI AI 工具集

assemblyai-sdk-patterns

设计与创作

查看项目

更新于 10-16 06:20

技能介绍

用途:为 AssemblyAI 集成设计一个应用自有的窄边界(typed adapter),把当前 SDK 封装在端口之后,使数据、凭据、区域、重试、开销与破坏性状态分别受控。适用于预录音频任务、Streaming v3 会话、临时令牌签发、webhook 与 LLM Gateway 请求等不同生命周期的集成场景。

主要能力:清点直接 SDK 导入并分类;定义窄化的请求、结果与稳定应用错误类型;集中管理不可变区域、认证、截止时间与重试策略;把任务提交与结果获取分离;对流的连接、开始、轮次、终止与确认建模;固定 SDK 版本并用契约夹具验证边界。新代码不应暴露旧版 LeMUR 方法或 Streaming v2 服务名。

使用方式:认证上,实时工作需从批准的密钥管理器注入 ASSEMBLYAI_API_KEY,仅将原始值放入发往配置的一方主机的 AssemblyAI Authorization 头;不得打印、提交、放入 URL 或暴露给不可信客户端。回调密钥与临时流令牌属独立凭据。检查仓库可用 Read、Glob、Grep;仅经批准才用 Write、Edit 修改实现或文档。

限制与边界:实时音频处理、生产凭据或端点变更、付费模型或容量变更、内容留存、回调重放、部署或删除均需责任所有人批准;仅只读检查和合成离线验证不授权实时厂商操作。常见失败模式包括单例中可变租户状态串扰、笼统重试导致重复计费、厂商响应对象跨越服务边界导致升级不安全。输出应包含操作范围、环境、区域、契约面、授权类别、模型与特性决策、确定性验证结果、无内容标识符、风险与清理/回滚状态,排除凭据、签名 URL、音频、转录文本、提示与客户派生内容。价格、限额、模型细节等请以带日期的一方证据为准。