POST
/
v1
/
audio
/
speech
文本转语音（TTS）
curl --request POST \
  --url https://llm.ai-nebula.com/v1/audio/speech \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "input": "<string>",
  "voice": "<string>",
  "response_format": "<string>",
  "speed": 123
}
'

​
简介

将文本转换为自然流畅的语音音频。该接口完全兼容 OpenAI 格式，您可以直接使用 OpenAI SDK 或兼容的客户端调用。

​
认证

​
Authorization
string
必填
Bearer Token，如 Bearer sk-xxxxxxxxxx

​
请求参数

​
model
string
必填
模型名称，如 gpt-4o-mini-tts
​
input
string
必填
要转换为语音的文本。
​
voice
string
必填
合成使用的音色，如 alloy、echo、fable、onyx、nova、shimmer
​
response_format
string
默认值:"mp3"
音频输出格式：mp3、opus、aac、flac、wav 或 pcm
​
speed
number
默认值:"1.0"
播放速度，范围 0.25 到 4.0

​
cURL 示例

curl https://llm.ai-nebula.com/v1/audio/speech \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-XyLy**************************mIqSt" \
  -d '{
    "model": "gpt-4o-mini-tts",
    "input": "Hello from Nebula",
    "voice": "alloy"
  }' \
  --output speech.mp3

​
Python 示例

from openai import OpenAI

client = OpenAI(
    api_key="sk-XyLy**************************mIqSt",
    base_url="https://llm.ai-nebula.com/v1"
)

response = client.audio.speech.create(
    model="gpt-4o-mini-tts",
    voice="alloy",
    input="Hello from Nebula"
)

response.stream_to_file("speech.mp3")

​
支持的音色

音色说明
alloy均衡、中性
echo平静、清晰
fable温暖、富有表现力
onyx低沉、有权威感
nova明亮、有活力
shimmer柔和、轻柔

​
注意事项

  • 响应体为原始二进制音频 —— 请将其写入文件（如 speech.mp3），不要直接打印
  • response_format 默认为 mp3；如需无损音频可使用 wav 或 pcm
  • 依赖 openai 库：pip install openai