用途:在集成 AssemblyAI 时安全完成密钥、区域端点与认证配置,区分服务端与浏览器端凭据边界。
主要能力:预录音频 REST 使用经批准的美国或欧盟 api.assemblyai.com 主机,并在 Authorization 头中携带原始项目密钥;流式使用 v3 WebSocket 主机。浏览器与移动端由可信后端下发短期、单次使用的流式令牌,绝不接触项目密钥。回调密钥与临时流式令牌属于独立凭据。
使用方式:从批准的密钥管理器注入 ASSEMBLYAI_API_KEY,仅发送到配置的第一方主机;固定官方 SDK 并集中管理端点配置;按环境隔离密钥;为不可信客户端设计受来源限制的令牌端点;用合成预录请求验证。
限制与边界:不得打印、提交密钥或将其放入 URL。区域错误属于数据驻留事件而非重试。浏览器代码中出现项目密钥即视为泄露并需轮换。不得为 REST 授权值添加未记录的 Bearer 方案。实时音频处理、生产凭据或端点变更、付费模型或容量变更、内容留存、回调重放、部署或删除均需责任人批准;仅调用本技能不授权任何实时厂商操作。输出应排除凭据、签名 URL、音频、转录文本与客户内容。