文本转语音

将文本合成为音频,需先确认平台开放了对应语音模型。

POST/v1/audio/speech

OpenAI 兼容

参数与透传

Headers请求头

左右滑动查看完整参数表

请求头
参数名类型必填说明默认值 / 示例
Authorizationstring必填

平台 API Key,使用 Bearer 认证。

示例
Bearer YOUR_API_KEY
Content-Typestring必填

请求体编码格式。

示例
application/json

Request Body请求体

application/json

左右滑动查看完整参数表

请求体
参数名类型必填说明默认值 / 示例
modelstring必填

模型 ID;请替换为账户可用且支持当前接口的模型。

示例
MODEL_ID
inputstring必填

需要合成为语音的文本;长度限制由模型决定。

示例
你好,欢迎使用语音服务。
voicestring必填

模型支持的音色。常见兼容音色如下,具体以所选模型为准。

可选值alloyechofableonyxnovashimmer
—
response_formatstring可选

输出音频格式。

可选值mp3opusaacflacwavpcm
—
speednumber可选

语速倍率;需模型支持。

—
instructionsstring可选

声音风格或情绪指令;仅部分语音模型支持。

—

使用说明

  • 成功响应为音频字节,请保存为对应音频文件,不要按 JSON 解析。
  • 示例选择 mp3;其他格式的响应 Content-Type 和文件扩展名相应变化。
  • 将 MODEL_ID 替换为平台可用的语音模型 ID;需要音色的接口请填写该模型支持的音色。