获取 API Key 获取 API
文档

TTS 文字转语音

- 支持多种语音模型和音色选择

  • 输出高质量音频格式:opus、aac、flac、wav、pcm
  • 最大输入文本 4096 个字符

请求示例

curl --request POST \
  --url https://api.openveer.com/v1/audio/speech \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-4o-mini-tts",
    "input": "今天天气真好,适合出去散步。",
    "voice": "alloy",
    "response_format": "opus",
    "speed": 1.0
  }' \
  --output speech.opus

响应示例

二进制音频数据流

Authorizations

Authorization string

所有接口均需要使用Bearer Token进行认证

获取 API Key:

访问 API Key 管理页面 获取您的 API Key

使用时在请求头中添加:

Authorization: Bearer YOUR_API_KEY

Body

model string

TTS 模型名称

可选值:

  • gpt-4o-mini-tts - GPT-4o Mini TTS 模型

Example: "gpt-4o-mini-tts"

input string

要转换为语音的文本内容

最大长度: 4096 个字符

Example: "今天天气真好,适合出去散步。"

voice string

语音音色选择

可选音色:

  • alloy - 中性、平衡的音色
  • echo - 男性、沉稳的音色
  • fable - 英式、叙述性的音色
  • onyx - 男性、深沉的音色
  • nova - 女性、活力的音色
  • shimmer - 女性、温柔的音色

Example: "alloy"

response_format string

音频输出格式

支持的格式:

  • wav - WAV 格式,未压缩(默认)
  • opus - Opus 格式,用于互联网流媒体
  • aac - AAC 格式
  • flac - FLAC 格式,无损压缩
  • pcm - PCM 格式,原始音频数据

Example: "wav"

speed number

语音播放速度

范围: 0.25 到 4.0

  • 0.25 - 最慢速度(1/4倍速)
  • 1.0 - 正常速度(默认)
  • 4.0 - 最快速度(4倍速)

Example: 1.0

Response

成功时返回二进制音频数据流,可直接保存为音频文件或播放。

错误时返回 JSON 格式的错误信息,包含错误代码、消息和类型。