任务进度查询（消除/修复）
● 服务正常
免费
GET
视频大模型
文档 doc/105
轮询 AI 消除、画质修复任务的结果，拿到处理后的视频直链。
GEThttps://api.vidtidy.cn/api/v1/task/status
鉴权：请求头 X-API-KEY: sk_live_…（也支持 key 查询参数）。
请求参数
| 名称 | 必填 | 类型 | 说明 |
|---|
taskId | 必填 |
string | 提交接口返回的任务 id |
返回参数
| 名称 | 类型 | 说明 |
|---|
schedule | number | 0 待处理 / 1 处理中 / 2 成功 / 3 失败 |
resultUrl | string | 处理后的视频直链 |
failCause | string | 失败原因 |
cost | string | 本次扣费金额（元，4 位小数） |
balance | string | 扣费后账户余额（元） |
返回示例
{
"code": 200,
"msg": "SUCCESS",
"data": {
"schedule": 2,
"resultUrl": "https://x.com/out.mp4"
}
}
说明：免费查询。schedule=2 时 resultUrl 才有效。
计费口径
| 项目 | 说明 |
|---|
| 计费方式 | 免费，不计费也不占用额度 |
| 我方单价 | 免费 |
| 上游原价 | 免费（我方含接入、重试、对账与技术支持的加价部分） |
| 预扣与退款 | 按秒/按字类接口在提交时预扣，上游返回业务失败码时 全额自动退回，无需申请 |
| 免费接口 | 任务查询类接口永远免费，高频轮询不会产生费用 |
| 最低余额 | 余额不足以支付本次预扣时会直接返回 402，不会先调用上游再报错 |
错误码
| code | 含义 | 处理建议 |
|---|
200 | 成功 | — |
-1 | 业务异常 | 见 msg。链接不支持 / 文件不可下载 / 时长超限最常见 |
401 | 密钥无效 | 检查请求头，或到控制台确认密钥未停用 |
402 | 余额不足 | 充值后重试，本次不扣费 |
429 | 频率超限 | 按 100 次/秒 退避 |
500 | 服务异常 | 上游故障，已自动退款 |
cURL
curl -G "https://api.vidtidy.cn/api/v1/task/status" \
-H "X-API-KEY: sk_live_你的密钥" \
-d "taskId=示例值"
Python
import requests
r = requests.get(
"https://api.vidtidy.cn/api/v1/task/status",
headers={"X-API-KEY": "sk_live_你的密钥"},
params={"taskId": "示例值"},
timeout=30,
)
print(r.json())Node.js
const url = new URL("https://api.vidtidy.cn/api/v1/task/status");
url.searchParams.set("taskId", "示例值");
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;