将文字合成为音频,适用于朗读、播报和配音。
请求
| 项目 | 说明 |
|---|---|
| 方法 | 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、模型名称、账户额度及参数;遇到限流时降低并发并稍后重试。