用途:为 @deepgram/sdk(TypeScript)与 deepgram-sdk(Python)提供生产级集成模式,适用于实现 Deepgram 集成、重构 SDK 用法或建立统一调用规范。
主要能力:单例客户端与环境变量校验;Aura-2 文本转语音并将流写入文件;音频智能流水线,包含摘要(summarize: 'v2')、主题检测、情感分析与意图识别;Python 生产服务类;类型化响应辅助函数;SDK v5 迁移参考。
使用方式:先安装依赖 npm install @deepgram/sdk 或 pip install deepgram-sdk,并配置 DEEPGRAM_API_KEY 环境变量。TypeScript 侧用 createClient(apiKey) 创建客户端,通过 deepgram.speak.request 调用 TTS,通过 deepgram.listen.prerecorded.transcribeUrl 调用转写;Python 侧用 DeepgramClient 与 PrerecordedOptions、SpeakOptions。建议将 SDK 封装在接收受限密钥引用、校验媒体元数据、设置超时与重试上限、仅输出脱敏请求指标的客户端之后,并用模拟响应做单元测试。
适用场景:语音转写、对话分析、语音合成及 SDK 版本升级。
限制与错误处理:401 表示密钥无效;400 表示音频格式不受支持,需转为 WAV/MP3/FLAC;speak.request is not a function 为 SDK 版本不匹配,v5 使用 speak.v1.audio.generate;TTS 空响应需先校验文本非空;summarize 返回 null 时需传入字符串 'v2' 而非布尔值。具体收费、价格与效果资料暂未提供。