用途:帮助把 ElevenLabs 文本转语音(TTS)/语音集成部署到生产环境,按清单逐项核对并接入弹性能力,降低上线风险。
主要能力:提供上线前验证清单,包括密钥与配置(生产 API key 存入安全保管库、部署平台 secrets 中设置 ELEVENLABS_API_KEY、webhook secret、使用生产模型 ID 如 eleven_multilingual_v2 或 eleven_v3)、代码质量(测试通过、无硬编码密钥、覆盖 400/401/404/429/5xx 错误处理、限流匹配套餐并发、文本分片处理超 5000 字符输入、输出音频格式适配场景)、配额规划(月度字符用量估算、按量计费、对延迟敏感场景使用 Flash/Turbo 模型)。还给出三类弹性原语:健康检查端点(报告连通性、延迟、剩余配额,配额超 90% 返回 degraded,API 失败返回 unhealthy)、熔断器(连续失败后打开、冷却后半开探测、支持占位音频/缓存片段/空的降级回退)、监控告警(每次 TTS 调用发出结构化指标并映射告警阈值)。
使用方式:按 Step 1 核对清单,每个未勾选项视为发布阻塞;Step 2 接入弹性原语,完整 TypeScript 实现见 references/implementation.md;Step 3 运行预检脚本,检查连通性、配额、语音可用性和实时 TTS 冒烟测试,失败以非零退出码阻断 CI/CD 部署,完整脚本与 CI 接入见 references/preflight.md。
监控与错误处理:给出告警矩阵,如 API 不可达连续失败 3 次为 P1、配额耗尽为 P1、5xx 超 5% 为 P2、429 持续超 10 次/分钟为 P2、p99 超 5000ms 与配额超 80% 为 P3;并说明 API 宕机时熔断降级、配额耗尽切换 Flash 模型、语音被删返回 404 并回退默认语音、webhook 连续失败 10 次后自动禁用等应对。
限制:资料未提供具体价格、收费、各套餐配额数值、支持的全部平台与语言列表;实际阈值与实现需以官方文档和自身环境为准。