用途:在遇到持续性问题、准备提交支持工单或需要收集诊断信息时,集中采集 ElevenLabs 的调试证据。
主要能力:收集 SDK 版本、API 连通性(HTTP 状态、DNS、TLS)、配额状态、语音清单和模型可用性,并打包为单个归档;所有密钥在写入磁盘前自动脱敏。提供两条等效采集路径:shell 脚本(无代码依赖,适合服务器和 CI)与 TypeScript 程序化采集器(适合已引入 SDK 的应用)。
使用方式:三步流程——运行采集器、检查输出是否残留敏感信息、附加到支持工单。shell 脚本将各段写入 summary.txt,脱敏后打包并删除工作目录,生成 elevenlabs-debug-YYYYMMDD-HHMMSS.tar.gz,内含 summary.txt、config-redacted.txt、errors.txt。程序化路径调用 collectDebugReport() 并输出 JSON。
前提条件:已安装 ElevenLabs SDK、已配置 API 密钥、可访问应用日志、shell 脚本需要 jq。
适用场景:提交支持工单、排查连通性或配额问题、定位单个端点的速率限制。
限制与说明:API 密钥、webhook 密钥及 .env 中 = 后的值会自动替换为 REDACTED,但分享前仍需人工确认错误日志或堆栈中无敏感信息;错误消息、堆栈、SDK/运行时版本、语音与模型 ID、HTTP 状态码和延迟可安全包含。常见问题包括 jq 未安装、网络故障、HTTP 401 密钥无效、新免费账户语音列表为空。支持工单提交地址为 https://help.elevenlabs.io。