翻译云开放接口

翻译云 API 文档

当前开放 TTS 语音合成能力,包含ttsTaskCreate任务创建与ttsTaskStatus任务查询两个接口。接入流程只有三步:拿到签名、提交任务、轮询结果。

Base URL
https://api.qutangkj.com/api/AIApi
鉴权方式
sign 参数
当前接口
2 个

1.1三步完成接入

  1. 获取签名:登录后进入签名页复制 sign,文档示例统一用 YOUR_SIGN 占位。
  2. 创建任务:调用 POST /ttsTaskCreate提交 text 与voice_role_id,拿到 task_id。
  3. 查询结果:轮询 /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.接口列表

接口方法路径说明
创建语音合成任务
ttsTaskCreate
POST/api/AIApi/ttsTaskCreate提交一段文本,创建语音合成任务并返回 task_id。
查询任务状态
ttsTaskStatus
GET/api/AIApi/ttsTaskStatus根据 task_id 查询任务进度、状态与音频下载地址。

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请求参数

参数名类型必填说明
signString是接口签名,登录后在签名页获取
voice_role_idString / Int是发音角色 ID,例如 70001(维吾尔语专用音色)
textString是待合成文本,最多 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返回字段

参数名类型说明
statusint接口状态码,200 表示请求成功
messagestring状态描述
timeint服务器时间戳(秒)
dataobject任务数据
└data.task_idint任务 ID,查询任务时使用
└data.statusint任务状态:1 成功,2 进行中,3 失败
└data.status_textstring任务状态描述

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请求参数

参数名类型必填说明
signString是接口签名,与创建任务使用同一个 sign
task_idString / 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返回字段

参数名类型说明
statusstring接口状态:200 = 成功
messagestring状态描述
timestring服务器时间戳(秒)
dataobject任务详情集合,key 为任务 ID
└data.{task_id}.statusstring任务状态:1 成功,2 进行中,3 失败
└data.{task_id}.status_textstring任务状态描述
└data.{task_id}.progress_percentint合成进度百分比
└data.{task_id}.target_file_urlstring音频 MP3 下载地址,任务成功后返回

6.4注意事项

  • 任务创建后不会立即完成,建议每 3~5 秒轮询一次。
  • 任务 status 为 1 后再读取 target_file_url,避免拿到空地址。

7.状态码

字段值含义
status200接口请求成功,可以继续读取 data
data.status1任务合成成功,可读取 target_file_url
data.status2任务合成中,建议继续轮询查询接口
data.status3任务合成失败,检查参数后重新提交

先判断接口 status = 200,再判断任务的 data.status,两层都通过才代表拿到音频地址。

8.注意事项

  • text 需要做 URL 编码,否则特殊字符可能导致请求失败。
  • sign、voice_role_id、task_id 都是必填参数。
  • voice_role_id=70001 当前对应维吾尔语专用音色。
  • 文档示例中的 YOUR_SIGN 需要替换为登录后在签名页获取的真实签名。
  • 后续新增接口(文本翻译、文档翻译、音视频等)会继续补充到左侧目录的对应分组。