POST
https://api.yuannengai.com
/
v1
/
audio
/
speech
curl --request POST \
  --url https://api.yuannengai.com/v1/audio/speech \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "tts-1",
    "input": "你好，欢迎使用原能引擎的语音合成服务。",
    "voice": "alloy"
  }' \
  --output speech.mp3

返回音频文件的二进制数据（Content-Type: audio/mpeg）
  • 支持多种音色
  • 高质量语音合成
  • 支持多种输出格式
curl --request POST \
  --url https://api.yuannengai.com/v1/audio/speech \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "tts-1",
    "input": "你好，欢迎使用原能引擎的语音合成服务。",
    "voice": "alloy"
  }' \
  --output speech.mp3

返回音频文件的二进制数据（Content-Type: audio/mpeg）

​
认证方式

​
Authorization
string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key：访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加：
Authorization: Bearer YOUR_API_KEY

​
请求参数

​
model
string
默认值:"tts-1"
必填
语音合成模型名称支持的模型：
  • tts-1 - 标准模型
  • tts-1-hd - 高清模型
​
input
string
必填
要转换为语音的文本最大长度：4096 字符
​
voice
string
必填
音色选择支持的音色：
  • alloy - 中性音色
  • echo - 男性音色
  • fable - 叙事风格
  • onyx - 深沉男声
  • nova - 女性音色
  • shimmer - 柔和女声
​
response_format
string
默认值:"mp3"
输出音频格式支持的格式：
  • mp3 - MP3 格式（默认）
  • opus - Opus 格式
  • aac - AAC 格式
  • flac - FLAC 格式
​
speed
number
默认值:"1.0"
语速调整，范围 0.25-4.0
  • 1.0 为正常语速
  • 小于 1.0 为慢速
  • 大于 1.0 为快速

​
响应说明

成功响应将直接返回音频文件的二进制数据。 响应头包含：
  • Content-Type: audio/mpeg（或对应的音频格式）
  • Content-Length: 音频文件大小
请将响应体保存为对应格式的音频文件。