/ 接口详情
语音合成-V1
语音合成 v1，传入文本与语言，返回 MP3 音频地址与元数据。
接口信息
GET / POST
api.vsaa.cn/api/tts/v1.php
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| key | string | 是 | 接口调用密钥 | |
| text | string | 是 | 内容 | 欢迎使用万象数据API |
| le | string | 否 | 语言 | zh |
[
{
"name": "key",
"type": "string",
"required": true,
"description": "接口调用密钥",
"example": ""
},
{
"name": "text",
"type": "string",
"required": true,
"description": "内容",
"example": "欢迎使用万象数据API"
},
{
"name": "le",
"type": "string",
"required": false,
"description": "语言",
"example": "zh"
}
]
{
"openapi": "3.1.1",
"info": {
"title": "语音合成-V1",
"description": "语音合成 v1，传入文本与语言，返回 MP3 音频地址与元数据。",
"version": "1.0.0"
},
"paths": {
"\/api\/tts\/v1.php": {
"get": {
"summary": "语音合成-V1",
"description": "语音合成 v1，传入文本与语言，返回 MP3 音频地址与元数据。",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "text",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "欢迎使用万象数据API"
},
"description": "内容"
},
{
"name": "le",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "zh"
},
"description": "语言"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application\/json": {
"schema": {
"type": "object"
}
}
}
}
}
},
"post": {
"summary": "语音合成-V1",
"description": "语音合成 v1，传入文本与语言，返回 MP3 音频地址与元数据。",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "text",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "欢迎使用万象数据API"
},
"description": "内容"
},
{
"name": "le",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "zh"
},
"description": "语言"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application\/json": {
"schema": {
"type": "object"
}
}
}
}
}
}
}
},
"servers": [
{
"url": "https:\/\/api.vsaa.cn",
"description": "当前访问入口（https）"
}
]
}
返回示例
{
"text": "欢迎使用万象数据API",
"language": "zh",
"type": 2,
"rate": 4,
"cached": false,
"content_type": "audio/mpeg",
"size": 47040,
"url": "https://api2.vsaa.cn/api/tts/audio/b8f4500db78b2fce5cbf88b701a0d7282431d7d9437b0795ebea0e380ef8c3db.mp3"
}
详细文档
语音合成-V1
接口说明
该接口支持通过文本生成语音文件，适用于需要动态生成音频内容的开发与集成场景。调用时需在查询参数中传入有效密钥进行身份验证。
调用地址
语音合成-V1 接口的调用地址为 /api/tts/v1.php。请通过 HTTPS 协议访问该端点以确保数据传输安全。
请求方式
该接口同时支持 GET 和 POST 两种请求方法。
- GET 请求：适用于将参数通过 URL 查询字符串（Query String）传递的场景，便于浏览器直接访问或简单脚本调用。
- POST 请求：适用于将参数封装在请求体中提交的场景，适合处理较长文本或更复杂的应用集成需求。
无论采用哪种请求方式，参数结构保持一致。建议根据实际业务场景选择合适的请求方法，注意遵守接口频率限制（每分钟约 60 次），避免高频调用导致服务不可用。
鉴权说明
调用此接口时必须携带有效的 API 密钥进行身份验证。本站采用查询参数（Query）方式进行鉴权，具体规则如下：
- 在请求 URL 的查询字符串中添加
key参数。 key参数值为您分配的唯一接口调用密钥。- 示例格式：
https://api2.vsaa.cn/api/tts/v1.php?key=your_api_key
重要提示：
- 密钥是访问本接口的必要凭证，缺失或错误的密钥将导致请求被拒绝。
- 请妥善保管您的 API 密钥，避免在公开场合或代码仓库中明文泄露。
- 每个密钥对应独立的调用权限与流量统计，切勿共享或转借。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 接口调用密钥，用于身份验证。 |
| text | string | 是 | 待合成的文本内容，示例：欢迎使用万象数据API。 |
| le | string | 否 | 语言类型，示例：zh。 |
成功响应示例
{
"text": "欢迎使用万象数据API",
"language": "zh",
"type": 2,
"rate": 4,
"cached": false,
"content_type": "audio/mpeg",
"size": 47040,
"url": "https://api2.vsaa.cn/api/tts/audio/b8f4500db78b2fce5cbf88b701a0d7282431d7d9437b0795ebea0e380ef8c3db.mp3"
}响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
text |
String | 输入的合成文本内容，原样返回以便核对。 |
language |
String | 合成音频所使用的语言代码，默认为 zh。 |
type |
Integer | 音频文件类型标识符，固定为 2，代表 MP3 格式。 |
rate |
Integer | 采样率标识符，固定为 4，对应 44.1kHz 标准。 |
cached |
Boolean | 是否命中缓存。false 表示本次为实时生成，true 表示返回已缓存的历史结果。 |
content_type |
String | 音频流媒体类型，固定为 audio/mpeg。 |
size |
Integer | 音频文件的大小的字节数（Byte）。 |
url |
String | 合成音频文件的临时访问链接，可直接下载或嵌入音频播放器。请注意该链接具有时效性，建议及时获取或使用。 |
错误响应示例
当请求验证失败或业务逻辑处理异常时，接口将返回统一的 JSON 格式错误信息。响应结构包含 code（主状态码，通常为 0 表示业务逻辑返回）、msg（人类可读的错误提示信息）以及 errcode（具体的业务错误码）。
{
"code": 0,
"msg": "未提供调用密钥",
"errcode": 11001
}其他常见错误场景的返回示例（结构相同，仅 msg 与 errcode 不同）：
{
"code": 0,
"msg": "密钥错误",
"errcode": 11002
}业务错误码说明
本接口在异常情况下返回具体的业务错误码（errcode），调用方应据此判断具体的错误原因并采取相应措施。以下为完整的错误码列表：
| 错误码 (errcode) | 含义说明 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁（QPM 限制） |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | ***地址无效 |
| 11015 | ***地址不允许 |
| 11016 | ***请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
| 11019 | 当前IP不在白名单内 |
| 11020 | 启用出口代理须提供有效密钥 |
| 11021 | 未配置可用出口代理 |
| 11022 | 出口代理不可用 |
| 11023 | 密钥已过期 |
| 11024 | 令牌分配积分不足 |
注意：
- 11001 - 11004：主要涉及鉴权与账户状态，需检查
key参数是否正确及账户权限。 - 11005：表示触发了频率限制（每分钟约 60 次），建议实现客户端限流或重试机制。
- 11006 - 11008, 11017：表明服务端或接口状态异常，通常需等待服务恢复。
- 11013 - 11016, 11017：涉及接口路由与服务可用性，若出现此类错误，请确认接口路径是否正确及服务状态。
- 11018：本接口仅支持 GET 和 POST 请求，使用其他 HTTP 方法将返回此错误。
调用示例
终端 curl（bash）
使用 GET 请求获取语音合成结果，将密钥和文本内容作为查询参数传递：
curl "https://api2.vsaa.cn/api/tts/v1.php?key=YOUR_API_KEY&text=欢迎使用万象数据API&le=zh"PHP
使用 cURL 扩展发送 GET 请求以调用接口：
// PHP
注意事项
- 密钥安全保管：
key是访问接口的必要凭证。请务必妥善保管密钥，避免在客户端（如 JavaScript 前端代码、移动应用包体）中直接明文硬编码，以防泄露。建议通过后端服务器中转调用或配合服务端环境变量管理密钥。 - 传输协议：调用接口时必须使用 HTTPS 协议，以确保请求参数（特别是密钥和待合成文本）在传输过程中的安全性和完整性，防止中间人攻击或窃听。
- 频率限制：接口每分钟允许调用约 60 次。请在应用逻辑中实现适当的请求节流或排队机制，避免短时间内集中发起大量请求导致触发限流失败。若需更高并发量，请联系官方支持。
- 参数取值规范：
text参数应传入待合成的具体文本内容，建议预先过滤特殊字符或过长文本，确保符合语音引擎的处理要求。le参数指定语言类型（如zh），请确认传入的值与支持的语言列表匹配，否则可能影响合成效果或导致错误。
- 返回内容处理：接口返回的
url字段为合成音频的文件链接（MP3 格式），该链接具有时效性或访问限制。获取响应后应尽快下载或流式处理音频数据，不要长期依赖该 URL 进行持久化存储，建议将音频文件保存至本地或自有存储系统中。 - 缓存标识：响应中的
cached字段表示是否命中缓存。虽当前接口计费免费，但频繁使用相同参数请求可能增加服务器负担，建议客户端自行维护结果缓存，避免重复请求相同内容的语音合成。
快速上手
暂无代码示例。管理员可在后台用 AI 生成或手动编写。
在线测试
请求地址
api.vsaa.cn/api/tts/v1.php
Method
参数
Response
// 结果将在此处显示
接口反馈
免责声明
免责声明
欢迎使用 万象数据API（以下简称“本平台”，域名为 api.vsaa.cn）。在使用本平台提供的任何接口、数据及相关服务之前，请您务必仔细阅读并充分理解本免责声明的全部内容。您对本平台任何服务的使用，均视为您已阅读、理解并同意本声明的全部条款。
最后更新日期：2026年10月6日
