用途:为 Speak 集成提供可观测性,监控 Speak API 健康状态、评估延迟、会话指标以及发音分数分布。适用于实现可观测性或管理 Speak 相关集成的场景。
前提条件:需完成 speak-install-auth 设置、配置有效的 API 凭据,并了解 Speak API 的使用模式。资料提到 Speak 使用 OpenAI 的 GPT-4o 进行 AI 辅导、Whisper 进行语音识别。
使用方式:先进行配置,设置 apiKey、appId 与 environment 等参数;再通过 @speak/language-sdk 的 SpeakClient 实现核心逻辑,例如调用 client.health.check() 获取健康状态;最后进行验证,可用 curl 请求健康检查接口:curl -sf -H "Authorization: Bearer $SPEAK_API_KEY" https://api.speak.com/v1/health | jq .
错误处理:401 Unauthorized 表示 API 密钥无效,需检查 SPEAK_API_KEY;429 Rate Limited 表示请求过多,需实现退避;连接超时需检查到 api.speak.com 的网络连通性;音频格式错误需转换为 WAV 16kHz 单声道。
适用场景:标准 Speak 集成的默认可观测性配置,以及带监控、告警和团队特定语言学习需求的生产环境配置。
限制:资料未提供具体收费、价格、平台支持范围或效果数据;生产环境检查清单需参考 speak-prod-checklist。