POST
同步文本转语音（TTS）接口
同步文本转语音服务，支持多家供应商的TTS模型，统一接口、统一调用参数
/api/v1/common/tts-sync
请求参数
请求头
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| X-API-Key | string | 必需 | 用户API密钥，用于身份验证 |
| Content-Type | string | 必需 | application/json |
请求体
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 必需 | TTS模型名称，可通过模型列表接口获取 |
| text | string | 必需 | 要转换为语音的文本内容（最大支持10,000字符） |
| voice | string | 必需 | 音色ID，每个模型下的音色唯一标识 |
| speed | number | 可选 | 语速倍率，范围0.5-2.0，默认1.0 |
| pitch | number | 可选 | 音调倍率，范围0.5-2.0，默认1.0 |
| volume | number | 可选 | 音量倍率，范围0.5-2.0，默认1.0 |
| format | string | 可选 | 输出音频格式，支持mp3、wav等，默认mp3 |
请求示例
curl -X POST https://unifiedtts.com/api/v1/common/tts-sync \
-H "X-API-Key: your-api-key-here" \
-H "Content-Type: application/json" \
-d '{
"model": "edge-tts",
"voice": "en-US-JennyNeural",
"text": "Hello, this is a test of text to speech synthesis.",
"speed": 1.0,
"pitch": 1.0,
"volume": 1.0,
"format": "mp3"
}'响应说明
成功响应 (200)
| 字段 | 类型 | 说明 |
|---|---|---|
| success | boolean | 操作是否成功 |
| message | string | 响应消息描述 |
| timestamp | number | 响应时间戳（Unix时间戳，毫秒） |
| data | object | 业务数据对象 |
| └─ request_id | string | 请求ID，用于追踪和调试 |
| └─ audio_url | string | 音频文件下载链接 |
| └─ file_size | number | 音频文件大小（字节） |
响应示例
{
"success": true,
"message": "Success",
"timestamp": 1703123456789,
"data": {
"request_id": "req_abc123456789",
"audio_url": "https://unifiedtts.com/api/v1/audio/download/abc123.mp3",
"file_size": 245760
}
}重要提示
每个模型支持的音色以官方模型支持为准，本接口可能存在延迟不准确的情况。如有疑问，请参考各TTS提供商的官方文档。