OpenTypeless

在 OpenTypeless 中配置 Deepgram Nova-3

本页说明如何把 Deepgram Nova-3 配置为 OpenTypeless 的流式语音识别服务，包括 API Key、WebSocket 端点、模型、成功检查和常见故障。配置事实于 2026-08-30 根据 Deepgram 官方文档复核。

官方资料

Deepgram API 入门

官方 API Key 与基本请求流程。

https://developers.deepgram.com/docs/getting-started-with-the-api

Deepgram 实时转写 WebSocket 参考

官方实时转写端点和参数说明。

https://developers.deepgram.com/reference/listen-live

Deepgram 模型与语言

核对 Nova 模型和语言支持时使用。

https://developers.deepgram.com/docs/models-languages-overview/

获取 API Key

  1. 登录 Deepgram，进入目标项目的控制台。
  2. 创建具备语音转文字权限的 API Key。
  3. 复制并妥善保存密钥，不要把密钥写入公开仓库或截图。

在 OpenTypeless 中配置

  1. 打开“设置 → 语音识别”，选择 Deepgram。
  2. 粘贴 Deepgram API Key。模型和 WebSocket 端点由当前内置路由提供。
  3. 多语言场景先使用自动检测；固定语言工作流可显式选择对应语言。
  4. 点击“测试”。成功状态应显示连接成功和延迟值，然后再做一次短句听写。

当前配置参考

OpenTypeless 的 Deepgram 内置路由使用安全 WebSocket 和 Nova-3。下面的端点与模型用于核对，不需要在内置供应商表单里手工改写。

Provider: deepgram
Protocol: WebSocket
Endpoint: wss://api.deepgram.com/v1/listen
Auth header: Authorization: Token <DEEPGRAM_API_KEY>
Model: nova-3
Audio: linear16, 16000 Hz, mono

常见故障：症状、原因、修复与验证

症状：测试按钮不可用或点击后没有请求

常见原因是 Deepgram API Key 为空。重新粘贴密钥后再测试；验证标准是页面返回连接成功和延迟值。

症状：返回认证失败

密钥可能无效、已撤销或不属于当前项目。到 Deepgram 控制台核对密钥和权限，再重新输入；不要修改内置 endpoint 或 nova-3 模型。

症状：连接测试成功，但实际听写不能持续返回文字

网络可能允许普通 HTTPS，却阻止到 api.deepgram.com 的安全 WebSocket。放行该主机的 WSS 连接后，用一条短句验证流式结果。

复核与下一步

💡
配置值于 2026-08-30 复核。若多语言标点不稳定，先固定语言做同一句对照测试；供应商更改模型或鉴权方式后，应重新核对官方文档。

资源