文档中心

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

视频号解析

● 服务正常 按量计费 GET 视频大模型 文档 doc/117

专门解析微信视频号。支持链接，也支持 objectId + objectNonceId 成对传入；加密视频会返回解密所需 key。

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

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

请求参数

名称必填类型说明
url选填 string视频号链接（与 objectId 二选一）
objectId选填 string视频号 id，需与 objectNonceId 成对
objectNonceId选填 string视频号 id 密钥，需与 objectId 成对

返回参数

名称类型说明
urlstring视频地址（加密视频为预览网页）
encryptionboolean是否加密
other.decodeKeystring加密视频的解密 key
other.eurlstring加密的视频链接
coststring本次扣费金额（元，4 位小数）
balancestring扣费后账户余额（元）

返回示例

{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "url": "https://cdn.example.com/wx.mp4",
    "title": "示例",
    "encryption": false
  },
  "cost": "0.0225",
  "balance": "48.9775"
}
说明：加密视频需要拿到 other.decodeKey 后自行解密，解密工具不在本接口范围内。

计费口径

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

错误码

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

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


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;