POST
/v1/audio/speech
文本转语音
将输入文本转换为可播放音频，兼容 OpenAI Audio Speech 接口。
认证
使用 Bearer Token 认证：Authorization: Bearer sk-xxxxxx
请求参数
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
model |
string | 是 | 模型名称，如 tts-1、tts-1-hd |
input |
string | 是 | 要转换为语音的文本，最大 4096 字符 |
voice |
string | 是 | 语音类型：alloy、echo、fable、onyx、nova、shimmer |
response_format |
string | 否 | 输出格式：mp3、opus、aac、flac、wav、pcm，默认 mp3 |
speed |
number | 否 | 语速范围 0.25 - 4.0，默认 1.0 |
请求示例
cURL
curl -X POST "https://your-base-url/v1/audio/speech" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxxxxx" \
-d '{
"model": "tts-1",
"input": "你好，欢迎使用 AI 语音服务",
"voice": "alloy"
}' \
--output speech.mp3响应说明
成功响应为音频二进制流，而非 JSON。可直接保存为文件并播放。
常见错误响应
400 Bad Request
{
"error": {
"message": "voice is not supported",
"type": "invalid_request_error",
"param": "voice",
"code": "invalid_voice"
}
}
在线测试
直接在此页面测试文本转语音接口