概览
翻译云开发者文档
这里是 API 平台总文档 ，当前先接入 TTS 模块 。
当前首页只先放入 TTS 相关接口，包含任务创建和任务状态查询。后续如果继续增加文本翻译、文档翻译、音视频等接口，会统一继续挂在左侧目录，而不是让整个页面只服务于 TTS。
鉴权方式
Sign
当前模块
TTS
当前已接入
2 个接口
鉴权说明
登录后获取签名
访问前提
必须先登录翻译云账号
鉴权参数
sign（每次请求必填）
签名展示位置
单独签名页面，不在文档页展示
推荐请求方式
POST + application/x-www-form-urlencoded
使用流程
- 先登录账号，再进入签名页面复制当前可用 sign。
- 创建任务时传入 `sign`、`voice_role_id`、`text`。
- 查询任务时传入 `sign` 与创建接口返回的 `task_id`。
- 文档页示例统一使用 `YOUR_SIGN` 占位，避免在公开页面暴露签名。
接口目录
当前接口模块
TTS 接口
已开放当前已接入模块，包含 ttsTaskCreate 与 ttsTaskStatus 两个接口。
文本翻译接口
规划中预留扩展位，后续可在左侧目录中继续增加文本翻译相关接口文档。
文档 / 音视频接口
规划中预留扩展位，后续将与 TTS 一样作为独立模块持续补充。
TTS
ttsTaskCreate - 创建任务
接口地址
https://api.qutangkj.com/api/AIApi/ttsTaskCreate
请求方式
GET / POST，建议使用 POST
接口用途
创建语音合成（TTS）任务
字符限制
text 最多支持 1000 字符
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sign | String | 是 | 接口签名（鉴权必填） |
| voice_role_id | String / Int | 是 | 发音角色 ID |
| text | String | 是 | 待合成文本，需进行 URL 编码 |
快速开始
curl
JavaScript
Python
Example
curl -X POST "https://api.qutangkj.com/api/AIApi/ttsTaskCreate" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "sign=YOUR_SIGN" \
-d "voice_role_id=70001" \
--data-urlencode "text=待合成文本内容"请求体示例
{
"sign": "YOUR_SIGN",
"voice_role_id": "70001",
"text": "待合成文本内容"
}成功响应示例
{
"status": 200,
"message": "成功",
"time": 1775389754,
"data": {
"task_id": 7674,
"status": 2,
"status_text": "合成中"
}
}返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
| status | int | 状态码，200 表示请求成功 |
| message | string | 状态描述 |
| time | int | 时间戳 |
| data | object | 任务数据 |
| data.task_id | int | 任务 ID |
| data.status | int | 任务状态码 |
| data.status_text | string | 任务状态描述 |
TTS
ttsTaskStatus - 查询任务状态
接口地址
https://api.qutangkj.com/api/AIApi/ttsTaskStatus
请求方式
GET / POST
接口用途
查询任务进度、状态与音频下载地址
返回结果
任务状态、进度百分比与 target_file_url
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sign | String | 是 | 接口签名 |
| task_id | String / Int | 是 | 任务 ID，由创建接口返回 |
GET 请求示例
curl -G "https://api.qutangkj.com/api/AIApi/ttsTaskStatus" \
--data-urlencode "sign=YOUR_SIGN" \
--data-urlencode "task_id=7675"成功响应示例
{
"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"
}
}
}返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
| status | string | 接口状态：200 = 成功 |
| message | string | 状态描述 |
| time | string | 时间戳 |
| data.{task_id} | 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 下载地址 |
状态码
统一状态说明
接口 status = 200
已开放表示接口请求成功，创建任务或查询任务时都以此为第一层判断条件。
任务 status = 1
已开放合成成功，可以读取返回中的音频下载地址。
任务 status = 2
已开放合成中，建议继续轮询 ttsTaskStatus 接口查询进度。
任务 status = 3
已开放合成失败，需要检查参数、文本内容或重新提交任务。
注意事项
接入时请重点关注
- `text` 必须做 URL 编码，否则特殊字符可能报错。
- 文本长度需控制在 1000 字符以内。
- `sign`、`voice_role_id`、`task_id` 都是强制必填参数。
- `voice_role_id=70001` 当前对应维吾尔语专用音色。
- 文档页示例中的 `YOUR_SIGN` 需要替换为登录后在签名页获取的真实签名。
更多接口
后续扩展方式
当前页面已经调整为开发者文档首页结构。后面新增接口时，可以继续沿用左侧目录追加独立模块，比如文本翻译、文档翻译、音视频翻译、回调通知、错误码等，而不需要再把整个页面重写成某一个单独接口的专页。
