接口说明
将文本转换为自然流畅的语音,支持多种发音人音色(男声/女声/童声),可调节语速、音调、音量参数。
平台提供稳定可靠的语音合成TTS服务,支持高并发调用,返回JSON格式数据。接口采用RESTful风格设计,接入简单,响应迅速,适用于各类业务场景的快速集成。
适用场景
📢 语音播报:新闻/通知/公告语音播报
📖 有声阅读:文章/小说自动转语音
🤖 智能客服:机器人语音应答和引导
🧭 导航提示:路线导航语音播报
请求参数
| 参数名 | 类型 | 必填 | 说明 |
| api_key | string | 是 | 用户的API密钥,在个人中心获取 |
| api | string | 是 | 接口标识,本接口为 audio.tts |
| image | string | 是 | 图片Base64编码字符串 |
| text | string | 否 | 文本内容(文本类接口需要) |
返回参数
| 参数名 | 类型 | 说明 |
| code | int | 状态码,200表示成功 |
| message | string | 状态描述 |
| data | object | 业务数据 |
| cost | string | 本次调用费用 |
| balance | string | 调用后账户余额 |
请求示例(PHP)
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, '/index.php?c=ApiGateway&a=call');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
'api_key' => 'your_api_key',
'api' => 'audio.tts',
'image' => base64_encode(file_get_contents('test.jpg'))
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
echo $result;
返回示例
{
"code": 200,
"message": "success",
"data": {
"words_result": [
{"words": "识别结果第一行"},
{"words": "识别结果第二行"}
]
},
"cost": "0.03",
"balance": "99.97"
}
错误码说明
| 错误码 | 说明 | 处理建议 |
| 400 | 请求参数错误 | 检查必填参数是否完整 |
| 401 | API Key无效 | 检查密钥是否正确 |
| 402 | 余额不足 | 请先充值 |
| 404 | 接口不存在 | 检查api参数 |
| 500 | 服务器错误 | 稍后重试 |