用途：为 ElevenLabs 文本转语音/语音应用提供生产级分层参考架构，适用于设计新的 ElevenLabs 集成或审查现有项目结构。
主要能力：将代码拆为六层——elevenlabs/（客户端、配置、模型、错误、类型）、services/（tts、voice、audio、cache）、api/（路由与中间件）、queue/、monitoring/。提供环境感知配置（开发用 eleven_flash_v2_5，生产用 eleven_multilingual_v2，并调整并发与缓存）；TTSService 封装单例客户端与按 maxConcurrency 配置的 p-queue 以抑制 429，支持流式与缓冲转换、延迟日志与错误分类，generateLongText() 在 5000 字符上限内按句子边界切分以保留韵律；VoiceService 支持列出、克隆、获取/更新设置、删除并按类别过滤（premade/cloned/generated）；以及用 Promise.allSettled 组合连接、配额与缓存检查的 /health 路由，返回 healthy/degraded/unhealthy（配额超 90% 即为 degraded）。
使用方式：需先了解分层架构模式与 ElevenLabs SDK，使用 TypeScript 异步项目，缓存可选 Redis。鉴权使用导出的 ELEVENLABS_API_KEY，由配置层读取；这是唯一的 ElevenLabs 凭据，应用自身请求鉴权（middleware/auth.ts）与其无关。示例中通过 new TTSService() 后调用 generate()（返回 Buffer 或开启 streaming 时返回 ReadableStream），generateLongText() 返回分块 Buffer[]。
限制与错误处理：常见问题包括循环依赖（服务依赖客户端，不可反向）、冷启动延迟（服务启动时预热）、内存压力（为缓存设置 maxSizeMB）、类型错误（固定 SDK 版本）、频繁 429（调低 maxConcurrency）、缺少 API 密钥（在 loadConfig() 前导出环境变量）。完整可运行代码在 references/ 中，具体平台、收费与价格信息暂未提供。