翻译云开放接口
翻译云 API 文档
当前开放 TTS 语音合成能力,包含ttsTaskCreate任务创建与ttsTaskStatus任务查询两个接口。接入流程只有三步:拿到签名、提交任务、轮询结果。
Base URL
https://api.qutangkj.com/api/AIApi
鉴权方式
sign 参数
当前接口
2 个
1.1三步完成接入
- 获取签名:登录后进入签名页复制
sign,文档示例统一用YOUR_SIGN占位。 - 创建任务:调用
POST /ttsTaskCreate提交text与voice_role_id,拿到task_id。 - 查询结果:轮询
/ttsTaskStatus,任务成功后读取target_file_url下载音频。
2.鉴权与签名
所有接口都需要携带 sign 参数。签名与账号绑定,需要登录后在签名页创建并复制,不要在公开页面或前端代码里暴露真实签名。
2.1获取签名
先登录翻译云账号,再进入签名页创建并复制签名。
2.2携带方式
- 创建任务:随表单参数提交
sign(application/x-www-form-urlencoded)。 - 查询任务:随查询参数提交
sign与task_id。 - 签名缺失或失效时,接口会返回失败,需要回到签名页重新获取。
Auth example
POST https://api.qutangkj.com/api/AIApi/ttsTaskCreate
Content-Type: application/x-www-form-urlencoded
sign=YOUR_SIGN&voice_role_id=70001&text=待合成文本内容2.3安全建议
- 在服务端调用接口,不要把签名写进前端代码或公开仓库。
- 签名泄露时,及时在签名页删除旧签名并重新创建。
- 示例中的
YOUR_SIGN需要替换为真实签名。
3.限制与建议
- 单次
text最多 1000 字符,超出需要拆分成多个任务。 - 一次请求只提交一段文本,对应一个合成任务。
- 查询任务建议每 3~5 秒轮询一次,任务成功(
data.status = 1)后停止轮询。 - 返回的
target_file_url是临时下载地址,建议及时转存到自己的存储。
4.接口列表
5.创建语音合成任务
POSTttsTaskCreate
提交一段文本,创建语音合成任务并返回 task_id。
5.1基本信息
- URLhttps://api.qutangkj.com/api/AIApi/ttsTaskCreate
- 方法POST(也支持 GET,建议使用 POST)
- Content-Typeapplication/x-www-form-urlencoded
- 认证需要在请求中携带 sign
5.2请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sign | String | 是 | 接口签名,登录后在签名页获取 |
| voice_role_id | String / Int | 是 | 发音角色 ID,例如 70001(维吾尔语专用音色) |
| text | String | 是 | 待合成文本,最多 1000 字符,需要做 URL 编码 |
请求示例
curl --request POST \
--url https://api.qutangkj.com/api/AIApi/ttsTaskCreate \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data 'sign=YOUR_SIGN' \
--data 'voice_role_id=70001' \
--data-urlencode 'text=待合成文本内容'成功响应示例
Response
200 OK
{
"status": 200,
"message": "成功",
"time": 1775389754,
"data": {
"task_id": 7674,
"status": 2,
"status_text": "合成中"
}
}宽屏下示例固定在页面右侧,并跟随当前接口自动切换。
5.3返回字段
| 参数名 | 类型 | 说明 |
|---|---|---|
| status | int | 接口状态码,200 表示请求成功 |
| message | string | 状态描述 |
| time | int | 服务器时间戳(秒) |
| data | object | 任务数据 |
| └data.task_id | int | 任务 ID,查询任务时使用 |
| └data.status | int | 任务状态:1 成功,2 进行中,3 失败 |
| └data.status_text | string | 任务状态描述 |
5.4注意事项
- text 必须做 URL 编码,否则特殊字符可能报错。
- 文本长度需控制在 1000 字符以内。
- voice_role_id 与音色绑定,更换音色需要更换角色 ID。
6.查询任务状态
GETttsTaskStatus
根据 task_id 查询任务进度、状态与音频下载地址。
6.1基本信息
- URLhttps://api.qutangkj.com/api/AIApi/ttsTaskStatus
- 方法GET / POST
- Content-Typeapplication/x-www-form-urlencoded
- 认证需要在请求中携带 sign
6.2请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sign | String | 是 | 接口签名,与创建任务使用同一个 sign |
| task_id | String / Int | 是 | 任务 ID,由创建任务接口返回 |
请求示例
curl --request GET \
--url 'https://api.qutangkj.com/api/AIApi/ttsTaskStatus?sign=YOUR_SIGN&task_id=7675'成功响应示例
Response
200 OK
{
"status": "200",
"message": "成功",
"time": "1775390202",
"data": {
"7675": {
"status": "1",
"status_text": "成功",
"progress_percent": 90,
"target_file_url": "https://fanyiyun-all-1313244116.cos.ap-guangzhou.myqcloud.com/.../177675.mp3"
}
}
}宽屏下示例固定在页面右侧,并跟随当前接口自动切换。
6.3返回字段
| 参数名 | 类型 | 说明 |
|---|---|---|
| status | string | 接口状态:200 = 成功 |
| message | string | 状态描述 |
| time | string | 服务器时间戳(秒) |
| data | object | 任务详情集合,key 为任务 ID |
| └data.{task_id}.status | string | 任务状态:1 成功,2 进行中,3 失败 |
| └data.{task_id}.status_text | string | 任务状态描述 |
| └data.{task_id}.progress_percent | int | 合成进度百分比 |
| └data.{task_id}.target_file_url | string | 音频 MP3 下载地址,任务成功后返回 |
6.4注意事项
- 任务创建后不会立即完成,建议每 3~5 秒轮询一次。
- 任务 status 为 1 后再读取 target_file_url,避免拿到空地址。
7.状态码
| 字段 | 值 | 含义 |
|---|---|---|
| status | 200 | 接口请求成功,可以继续读取 data |
| data.status | 1 | 任务合成成功,可读取 target_file_url |
| data.status | 2 | 任务合成中,建议继续轮询查询接口 |
| data.status | 3 | 任务合成失败,检查参数后重新提交 |
先判断接口 status = 200,再判断任务的 data.status,两层都通过才代表拿到音频地址。
8.注意事项
text需要做 URL 编码,否则特殊字符可能导致请求失败。sign、voice_role_id、task_id都是必填参数。voice_role_id=70001当前对应维吾尔语专用音色。- 文档示例中的
YOUR_SIGN需要替换为登录后在签名页获取的真实签名。 - 后续新增接口(文本翻译、文档翻译、音视频等)会继续补充到左侧目录的对应分组。