Deepgram 语音 API 免费注册领 200 美元额度

拿到 API Key 后即可通过 HTTPS 调用 Deepgram 的语音接口。语音转写与语音合成走的是不同的 HTTP 路径，但都使用同一个密钥做鉴权，密钥放在请求头 Authorization 中，格式为 Token 你的密钥。具体接口域名与版本路径以官方文档和控制台显示为准。

鉴权与 base_url 形态

接口根地址形如 https://api.deepgram.com/v1/，语音转写对应 /listen，语音合成对应 /speak。建议把密钥写入环境变量，避免硬编码到代码里：

export DEEPGRAM_API_KEY="你的_API_Key"

一次语音转写调用示例

下面用 curl 提交一段远程音频地址做转写，关键参数包括 model（识别模型，如 nova-3、nova-2 等，可用模型列表以控制台或官方文档为准）、language（语言代码，如 zh-CN、en-US）、smart_format（是否自动加标点与数字格式化）、punctuate（是否加标点）。

curl -X POST "https://api.deepgram.com/v1/listen?model=nova-3&language=zh-CN&smart_format=true&punctuate=true" \
  -H "Authorization: Token $DEEPGRAM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/audio/sample.mp3"}'

若音频在本地，可改为直接上传二进制流：

curl -X POST "https://api.deepgram.com/v1/listen?model=nova-3&language=zh-CN&smart_format=true" \
  -H "Authorization: Token $DEEPGRAM_API_KEY" \
  -H "Content-Type: audio/mpeg" \
  --data-binary @sample.mp3

语音合成则向 /speak 发送 JSON 请求体，指定 text 与音色模型，返回音频二进制，可重定向保存为文件：

curl -X POST "https://api.deepgram.com/v1/speak?model=aura-asteria-en" \
  -H "Authorization: Token $DEEPGRAM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello from Deepgram text to speech."}' \
  --output output.mp3

额度耗尽与限流的典型表现

• 返回 401 或 403：密钥错误、已被删除，或请求头没有按 Token 前缀书写。
• 返回 402 或提示额度不足：赠送额度已用完或已过期，需要充值后继续调用。
• 返回 429：触发速率限制，需要降低并发或加入退避重试。
• 返回 400：参数拼写错误，如模型名不存在、语言代码不被该模型支持、音频格式与 Content-Type 不一致。

排查顺序

1. 先在控制台用量页面确认额度余额与密钥状态，排除额度问题。
2. 用 curl 最小请求验证鉴权，确认是密钥问题还是业务参数问题。
3. 核对 model 与 language 组合是否被支持，长音频是否需要改用异步回调模式。
4. 检查网络与音频文件本身，采样率过低或编码不受支持时会返回解析错误。
5. 出现持续 429 时，降低请求频率并按指数退避重试，必要时在控制台申请提高配额。