文档中心

统一 RESTful 规范 · 全部接口共用一套密钥与账单

语音合成结果查询

● 服务正常 免费 GET 语音合成 文档 doc/116

轮询文字转语音任务，返回音频直链、字数与格式。

调用权限
正常
请求频率
100 次/秒
免费额度
无限
参考价格
免费
立即充值 获取密钥
GEThttps://api.vidtidy.cn/api/v1/tts/status

鉴权：请求头 X-API-KEY: sk_live_…（也支持 key 查询参数）。

请求参数

名称必填类型说明
recordId必填 string文字转语音接口返回的任务 id

返回参数

名称类型说明
statusstringprocessing / completed / failed
urlstring音频地址，有效期 24 小时
charCountnumber计费字数
audioFormatstring音频格式
coststring本次扣费金额（元，4 位小数）
balancestring扣费后账户余额（元）

返回示例

{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "status": "completed",
    "url": "https://x.com/a.mp3",
    "charCount": 160
  }
}
说明：免费查询。返回 processing 时继续轮询即可，建议 3–5 秒一次。

计费口径

项目说明
计费方式免费，不计费也不占用额度
我方单价免费
上游原价免费（我方含接入、重试、对账与技术支持的加价部分）
预扣与退款按秒/按字类接口在提交时预扣，上游返回业务失败码时 全额自动退回，无需申请
免费接口任务查询类接口永远免费，高频轮询不会产生费用
最低余额余额不足以支付本次预扣时会直接返回 402，不会先调用上游再报错

错误码

code含义处理建议
200成功—
-1业务异常见 msg。链接不支持 / 文件不可下载 / 时长超限最常见
401密钥无效检查请求头，或到控制台确认密钥未停用
402余额不足充值后重试，本次不扣费
429频率超限按 100 次/秒 退避
500服务异常上游故障，已自动退款
cURL 
curl -G "https://api.vidtidy.cn/api/v1/tts/status" \
  -H "X-API-KEY: sk_live_你的密钥" \
  -d "recordId=示例值"
Python 
import requests

r = requests.get(
    "https://api.vidtidy.cn/api/v1/tts/status",
    headers={"X-API-KEY": "sk_live_你的密钥"},
    params={"recordId": "示例值"},
    timeout=30,
)
print(r.json())
Node.js 
const url = new URL("https://api.vidtidy.cn/api/v1/tts/status");
url.searchParams.set("recordId", "示例值");

const res = await fetch(url, {
  headers: { "X-API-KEY": "sk_live_你的密钥" },
});
console.log(await res.json());
PHP 
 true,
  CURLOPT_HTTPHEADER => ["X-API-KEY: sk_live_你的密钥"],
]);
$out = curl_exec($ch);
curl_close($ch);
echo $out;