Deepgram（音频转录）

适用范围

在以下情况下使用本页面：

• 您希望为音频附件使用 Deepgram 语音转文本功能
• 您需要快速配置 Deepgram 的示例

Deepgram 是一个语音转文本 API。在 Moltbot 中，它通过 tools.media.audio 用于接收音频/语音消息的转录。

启用后，Moltbot 会将音频文件上传到 Deepgram，并将转录内容注入到回复管道中（{{Transcript}} + [Audio] 块）。这不是流式传输；它使用预录制的转录端点。

官方网站：https://deepgram.com 文档：https://developers.deepgram.com

快速开始

1. 设置您的 API 密钥：

DEEPGRAM_API_KEY=dg_...

2. 启用提供商：

{
  tools: {
    media: {
      audio: {
        enabled: true,
        models: [{ provider: "deepgram", model: "nova-3" }]
      }
    }
  }
}

配置选项

• model：Deepgram 模型 ID（默认：nova-3）
• language：语言提示（可选）
• tools.media.audio.providerOptions.deepgram.detect_language：启用语言检测（可选）
• tools.media.audio.providerOptions.deepgram.punctuate：启用标点符号（可选）
• tools.media.audio.providerOptions.deepgram.smart_format：启用智能格式化（可选）

带语言提示的示例：

{
  tools: {
    media: {
      audio: {
        enabled: true,
        models: [
          { provider: "deepgram", model: "nova-3", language: "en" }
        ]
      }
    }
  }
}

带 Deepgram 选项的示例：

{
  tools: {
    media: {
      audio: {
        enabled: true,
        providerOptions: {
          deepgram: {
            detect_language: true,
            punctuate: true,
            smart_format: true
          }
        },
        models: [{ provider: "deepgram", model: "nova-3" }]
      }
    }
  }
}

注意事项

• 身份验证遵循标准提供商身份验证顺序；DEEPGRAM_API_KEY 是最简单的方式。
• 使用代理时，可以通过 tools.media.audio.baseUrl 和 tools.media.audio.headers 覆盖端点或请求头。
• 输出遵循与其他提供商相同的音频规则（大小上限、超时、转录注入）。