用途:安装并配置 Deepgram SDK 的 API 密钥认证,用于接入其语音转文字(Nova-3、Nova-2)、文字转语音(Aura-2)与音频智能 API。
主要能力:提供 Node.js 与 Python 两种 SDK 的安装、密钥配置、客户端初始化、连接验证和生产环境单例封装步骤,并说明密钥权限范围与常见错误处理。
使用方式:前置条件为 Node.js 18+ 或 Python 3.10+、Deepgram 账号及 Console 中创建的 API 密钥。安装命令:Node.js 用 npm install @deepgram/sdk 或 pnpm add @deepgram/sdk;Python 用 pip install deepgram-sdk。密钥通过环境变量 export DEEPGRAM_API_KEY="your-api-key-here" 或 .env 文件配置,禁止硬编码。TypeScript 用 createClient()(v3/v4)或 new DeepgramClient()(v5+)初始化;Python 用 DeepgramClient(os.environ["DEEPGRAM_API_KEY"])。验证可调用 manage.getProjects() 列出项目。生产环境建议使用单例客户端并检查密钥是否存在。
密钥范围:member 全权限(仅开发)、listen 转写、speak 合成、manage 项目管理、usage 用量监控,可在 Console 创建限定范围的密钥。
限制与错误:401 表示密钥无效或过期,403 表示缺少所需范围,MODULE_NOT_FOUND 表示未安装 SDK,ENOTFOUND 为网络或 DNS 问题,TypeError: createClient is not a function 表示安装了 v5 需改用 new DeepgramClient()。若密钥出现在仓库、日志或工单中,应立即撤销并更换。具体收费、价格与平台支持范围资料未提供。