参数名	类型	必填	说明
key	string	是	接口调用密钥，也支持通过 X-API-Key 请求头或 Authorization: Bearer 传递
text	string	是	需要转换为语音的文本，最多 500 个字符
msg	string	否	text 的兼容参数，旧版接口使用此参数
provider	string	否	语音引擎，当前仅支持 baidu，默认值为 baidu
type	string	否	provider 的兼容参数，传 baidu
voice	integer	否	百度音色编号，默认值为 4
id	string	否	voice 的兼容参数，也可传 list 获取音色列表
language	string	否	语音语言，例如 zh、en；默认根据文本自动判断
le	string	否	language 的兼容参数
rate	integer	否	语速，取值范围 0 到 10，默认值为 4
mode	string	否	返回模式，可选 json 或 audio，默认值为 json
format	string	否	mode 的兼容参数，可选 json 或 audio

语言合成_v2

接口说明

该接口将指定文本转换为语音音频流，适用于需要文本转语音功能的开发者及应用程序。支持自定义音色、语速及返回格式，免费调用且需通过 Query 参数传递密钥进行鉴权。

调用地址

/api/tts/v2.php

请求方式

GET 或 POST

鉴权说明

接口调用需携带密钥。通过 Query 参数 key 传递密钥，该参数为必填项。

请求参数

参数名	类型	必填	说明
key	string	是	接口调用密钥。
text	string	是	需要转换为语音的文本，最多 500 个字符。
msg	string	否	text 的兼容参数，旧版接口使用此参数。
provider	string	否	语音引擎，当前仅支持 baidu，默认值为 baidu。
type	string	否	provider 的兼容参数，传 baidu。
voice	integer	否	音色编号，默认值为 4。
id	string	否	voice 的兼容参数；也可传 list 获取音色列表。
language	string	否	语音语言，例如 zh、en；默认根据文本自动判断。
le	string	否	language 的兼容参数。
rate	integer	否	语速，取值范围 0 到 10，默认值为 4。
mode	string	否	返回模式，可选 json 或 audio，默认值为 json。
format	string	否	mode 的兼容参数，可选 json 或 audio。

成功响应示例

{
  "text": "欢迎使用万象数据API",
  "provider": "baidu",
  "language": "zh",
  "voice": 4,
  "id": "",
  "rate": 4,
  "cached": false,
  "content_type": "audio/mpeg",
  "size": 22176,
  "url": "https://api2.vsaa.cn/api/tts/audio.php/MDM2YWRiYmM0YzQ2YjNhNzFlNjI0MWNmMmU1NzQ4Yzk2YThjYmU0YTkwYjAxOGE4YjQwMDczNmI2ZjRiNzhiMi4xNzg5NzM1NjAx.1553a105ce363a76a4c66592d922da107c73e62df98a5b28ac0566d62e1639ec",
  "expires_in": 300
}

响应字段说明

字段名	类型	说明
text	string	本次请求提交的合成文本内容。
provider	string	使用的语音引擎标识，当前固定为 `baidu`。
language	string	合成的语音语言代码，如 `zh`、`en` 等。
voice	integer	对应的音色编号，默认为 4。
id	string	音色编号的兼容字段，通常为空字符串。
rate	integer	实际应用的语速数值，范围 0-10。
cached	boolean	标识该结果是否来自缓存，`false` 表示实时生成。
content_type	string	音频文件的 MIME 类型，如 `audio/mpeg`。
size	integer	音频文件的大小，单位为字节（Bytes）。
url	string	音频文件的有效访问链接。
expires_in	integer	链接或缓存的有效时长，单位为秒。

错误响应示例

调用「语言合成_v2」接口时，若发生鉴权失败、参数校验错误或业务逻辑限制，接口将返回统一的 JSON 错误结构。code 字段固定为 0，msg 字段包含人类可读的错误描述，errcode 字段标识具体的业务错误代码。

以下是一个当调用密钥缺失或无效时的错误响应示例：

{
  "code": 0,
  "msg": "未提供调用密钥",
  "errcode": 11001
}

当密钥余额不足或积分系统异常时，响应示例如下：

{
  "code": 0,
  "msg": "积分余额不足",
  "errcode": 11004
}

业务错误码说明

本接口在鉴权、计费及请求校验过程中可能返回以下业务错误码。开发者应根据 errcode 值判断错误类型并采取相应处理措施。

错误码 (errcode)	错误含义	说明与建议
11001	未提供调用密钥	请求中未携带 `key` 参数。请检查是否遗漏必填鉴权参数。
11002	密钥错误	提供的密钥无效或不存在。请核实密钥拼写是否正确。
11003	密钥已禁用	该密钥已被手动禁用或停用。请联系管理员恢复状态。
11004	积分余额不足	账户积分不足以支付本次调用费用。请充值或检查计费策略。
11005	请求过于频繁	触发 QPM（每分钟请求数）限制（约 60 次/分钟）。请增加请求间隔。
11006	接口维护中	当前接口处于计划内维护状态。请稍后重试。
11007	接口已禁用	该接口已被后台禁用，暂不可用。
11008	接口不可用	接口因未知原因暂时不可用，请稍后重试。
11009	密钥校验暂不可用	鉴权服务出现临时故障，无法完成密钥校验。
11010	积分系统暂不可用	计费服务出现临时故障，无法验证余额。
11011	收费接口须提供有效密钥	该接口为收费接口，必须通过有效密钥鉴权。
11012	鉴权方式错误	密钥传递方式不符合要求，请确保通过 Query 参数传递。
11013	接口不存在	请求的 API 路径无效或已下线。
11014	***地址无效	后端语音引擎地址配置错误或无法解析。
11015	***地址不允许	请求指定的引擎地址不在允许列表内。
11016	***请求失败	后端语音引擎返回错误或超时。
11017	服务暂不可用	底层服务资源紧张或故障，请稍后重试。
11018	请求方式不允许	该接口不支持当前 HTTP 方法（仅限 GET 或 POST）。
11019	当前IP不在白名单内	调用方 IP 地址未在服务白名单中。
11020	启用出口代理须提供有效密钥	涉及代理配置时缺失有效鉴权信息。
11021	未配置可用出口代理	系统未检测到可用的出口代理配置。
11022	出口代理不可用	配置的出口代理连接失败或不可用。
11023	密钥已过期	提供的密钥已超过有效期。请更换新密钥。
11024	令牌分配积分不足	当前令牌分配的积分额度不足，无法执行扣费。

调用示例

终端 curl（bash）

以下示例展示如何通过 GET 请求调用语言合成接口，并将密钥通过查询参数传递。请将 YOUR_KEY 替换为您的实际密钥。

curl -X GET "https://api2.vsaa.cn/api/tts/v2.php?key=YOUR_KEY&text=你好，世界&voice=4&rate=4&mode=json"

若需获取音频流而非 JSON 元数据，可将 mode 参数改为 audio：

curl -X GET "https://api2.vsaa.cn/api/tts/v2.php?key=YOUR_KEY&text=你好，世界&mode=audio" -o output.mp3

PHP

以下 PHP 示例演示如何发起 POST 请求以调用语言合成接口。密钥通过查询字符串附在 URL 中。请将 YOUR_KEY 替换为实际密钥。

// PHP 示例：POST 请求调用 TTS 接口
$key = 'YOUR_KEY';
$text = '欢迎使用万象数据API';
$url = 'https://api2.vsaa.cn/api/tts/v2.php?key=' . urlencode($key);

$payload = [
    'text' => $text,
    'voice' => 4,
    'rate' => 4,
    'mode' => 'json'
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($payload));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

注意事项

密钥安全：请勿在浏览器端、移动端 APP 或任何公开仓库中硬编码密钥，建议通过服务端代理调用以规避泄露风险。
文本长度：单次请求的 text 参数最大支持 500 个字符，超出部分可能导致截断或报错，长文本需分段处理。
频率限制：接口限制为每分钟约 60 次请求，高频调用时请注意合并请求或增加重试间隔，避免触发限流。
参数兼容：接口同时支持新版参数（如 text、provider）和旧版兼容参数（如 msg、type、id、le、format），建议统一使用新版参数以保证语义清晰。
返回模式：默认返回 JSON 格式包含音频 URL，若设置 mode 为 audio 则直接返回二进制音频流，请根据客户端处理逻辑选择。
链接时效：JSON 模式返回的 url 具有时效性（expires_in 指定有效期），请勿将其作为永久链接存储，需在使用后立即下载。
音色选择：voice 参数目前仅支持百度引擎默认音色及编号，如需获取可用音色列表可传入 id=list 进行查询。

免责声明

欢迎使用 万象数据API（以下简称“本平台”，域名为 api.vsaa.cn）。在使用本平台提供的任何接口、数据及相关服务之前，请您务必仔细阅读并充分理解本免责声明的全部内容。您对本平台任何服务的使用，均视为您已阅读、理解并同意本声明的全部条款。

1. 本平台仅提供**技术接口与数据聚合服务**，不存储、不生产、不拥有任何原始数据内容。 2. 本平台所返回的数据均来源于公开网络或第三方接口，仅作**技术学习、研究与交流**之用。 3. 本平台不保证任何接口的**持续可用性、准确性、完整性或及时性**，接口可能因第三方原因随时变更、中断或停止。 1. 使用者应遵守中华人民共和国相关法律法规，以及其所在地的所有适用法律。 2. **禁止**将本平台接口用于任何违法违规用途，包括但不限于： - 侵犯他人知识产权、隐私权或其他合法权益； - 从事网络攻击、数据爬取滥用、恶意刷量等行为； - 传播违法、有害、虚假或不良信息； - 用于任何商业转售、二次分发而未获授权的情形。 3. 使用者应自行承担因使用本平台服务而产生的一切后果与法律责任。 1. 本平台**不收集、不存储**使用者的个人敏感信息。 2. 使用者通过接口提交的查询参数，仅用于当次请求处理，不做持久化留存。 3. 若接口涉及第三方数据，其版权与解释权归原数据方所有，本平台不承担相关争议责任。 1. 本平台以**“现状”**和**“现有”**为基础提供服务，不对服务作出任何明示或暗示的担保。 2. 因使用或无法使用本平台服务而导致的任何**直接、间接、偶然或必然损失**，本平台及其运营者均不承担任何责任。 3. 因不可抗力、网络故障、第三方服务中断、政策调整等原因导致的服务异常，本平台不承担责任。 1. 本平台的接口设计、文档、代码及相关标识，其知识产权归本平台所有。 2. 未经书面许可，任何单位或个人不得复制、修改、传播或用于商业用途。 1. 本平台有权随时修改本免责声明，修改后的内容将在本页面公布，不再另行通知。 2. 使用者应定期查阅本声明，继续使用即视为接受变更后的条款。 1. 本声明的最终解释权归 **万象数据API** 所有。 2. 如您不同意本声明的任何内容，请立即停止使用本平台服务。 3. 如因本声明产生争议，双方应友好协商解决；协商不成的，可提交本平台运营者所在地有管辖权的人民法院裁决。

最后更新日期：2026年10月6日

语言合成_v2

接口信息

请求参数

返回示例

详细文档

语言合成_v2

接口说明

调用地址

请求方式

鉴权说明

请求参数

成功响应示例

响应字段说明

错误响应示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

注意事项

快速上手

在线测试

接口反馈

免责声明

免责声明

推荐接口

QQ免输收款码