请输入
菜单

文本转语音(OpenAI)

将文字合成为音频,适用于朗读、播报和配音。

请求

项目 说明
方法 POST
路径 /v1/audio/speech
网关地址 https://ailink.nativex.com
认证 Authorization: Bearer sk-xxxx,替换为你的 API Key
请求格式 application/json

示例中的 MODEL_ID 请替换为「模型广场」中支持本接口的模型名称。模型、参数支持范围与可用权限以当前账户为准。

参数说明

参数 位置 类型 必填 说明
model Body string 是 支持语音合成的模型
input Body string 是 需要朗读的文本;传统 TTS 接口上限为 4096 字符,其他模型以各自限制为准
voice Body string 是 音色;传统 TTS 可选 alloy、echo、fable、onyx、nova、shimmer,其他模型可能不同
response_format Body string 否 mp3、opus、aac、flac、wav 或 pcm;传统接口默认 mp3
speed Body number 否 语速,传统接口为 0.25~4,默认 1;是否支持取决于模型

调用示例

curl -X POST 'https://ailink.nativex.com/v1/audio/speech' \
  -H 'Authorization: Bearer sk-xxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "MODEL_ID",
  "input": "欢迎使用 AiLink。",
  "voice": "alloy",
  "response_format": "mp3"
}' \
  --output 'speech.mp3'

响应

成功后返回文件二进制内容。上面的 --output 会将结果保存到本地文件;请勿按 JSON 解析。

字段或结果 说明
音频文件 按 response_format 指定的格式保存

错误处理

非成功响应时,先查看 HTTP 状态和错误正文。检查 API Key、模型名称、账户额度及参数;遇到限流时降低并发并稍后重试。

最近修改: 2026-10-28