用途:配置 Speak 语言学习平台的 API 集成与认证,为后续调用其 AI 辅导与实时发音反馈能力做准备。Speak 使用 OpenAI 的 GPT-4o 与 Realtime API 提供 AI 辅导,支持 14 种以上语言,包括韩语、西班牙语、日语、法语和普通话。
前提条件:Node.js 18+ 或 Python 3.10+;拥有 API 访问权限的 Speak 开发者账号;用于语音输入测试的麦克风。
主要步骤:
- 安装依赖:npm install @speak/language-sdk,以及音频处理依赖 npm install openai、npm install fluent-ffmpeg、npm install node-record-lpcm16。
- 配置认证:设置环境变量 SPEAK_API_KEY、SPEAK_APP_ID 和 OPENAI_API_KEY,并写入 .env 文件。
- 初始化客户端:从 @speak/language-sdk 导入 SpeakClient,传入 apiKey、appId 与目标语言(如 es、ko、ja、fr、de、pt、zh、id),调用 getLanguages() 与 health.check() 验证连接。
- 配置语音识别:使用 OpenAI 的 audio.transcriptions.create 与 whisper-1 模型进行语音转文字,language 参数需与目标语言一致。
支持语言:韩语 ko、西班牙语 es、日语 ja、法语 fr、德语 de、葡萄牙语(巴西)pt、简体中文 zh-CN、英语 en、印尼语 id,均支持发音与对话。
输出结果:Speak SDK 安装并配置完成、API 密钥与 OpenAI 凭据已设置、语言支持已验证、语音识别流程就绪。
错误处理:Invalid API Key 需在 developer.speak.com 仪表板核对;App ID Mismatch 需检查 Speak 仪表板应用设置;OpenAI auth failed 需在 platform.openai.com 核对;Module not found 需重新运行 npm install;Language not supported 需使用支持语言表中的代码。
后续步骤:认证成功后,可进入 speak-hello-world 开始首个课程会话。Python 方式为通过 pip 安装 speak-language-sdk,用环境变量中的 api_key 初始化并做健康检查。
限制:资料未提供具体收费、价格、配额或平台兼容性细节。