视频号API接口文档
详细的视频号去水印API使用说明和示例代码
API概览
奇云API提供简单易用的RESTful接口，支持视频号去水印
提示：视频号视频地址请在小程序里播放和下载（真机调试），浏览器可能播放不了
重要提示：
目前已支持返回无加密视频地址，视频直链。但是解密方式还是支持，避免后续不能返回视频直链，随时切换为解密方式
视频号用户需自己部署解密服务下载，提供你的小程序用户体验加快下载。官网后续不再提供中转服务，具体可查看官网发布的文章：《视频号用户部署指南》99.9%
服务可用性
< 0.5s
平均响应时间
100%
视频号支持
基础信息
请求地址
https://qyapi.ipaybuy.cn/api/sph_parse请求方法
GETContent-Type
application/json请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
appId | string | 是 | 应用ID，在奇云平台注册获取 |
appKey | string | 是 | 应用密钥，在奇云平台注册获取 |
url | string | 否 | 视频号的分享链接（链接方式和视频ID选一） |
Oid | string | 否 | 视频号视频ID 视频号的ObjectID |
ONid | string | 否 | 视频号视频唯一标识 视频号的ObjectNonceID。 objectId与objectNonceId需自行获取，大概就是使用hook获取到用户发送来的视频号消息，从视频号消息中提取出两个值 |
代码示例
cURL示例
get方式：
curl -X GET "https://qyapi.ipaybuy.cn/api/sph_parse?appId=您的应用ID&appKey=您的应用密钥&url=视频号分享链接&Oid=视频ID&ONid=视频唯一标识"
响应参数
成功响应示例
{
"code": 200,
"data": {
"mediaUrl": "https://finder.video.qq.com/251/20304/stodownload?encfilekey=...",
"urlToken": "url_token_value",
"decode_key": "decode_key_value",
"title": "#旧衣回收 #旧衣服回收 #上门回收",
"video_url": "https://dw.ipaybuy.cn/wechat?url=...",
"video_url_v2": "encrypted_url_value",
"iteration": 1,
"cover_url": "https://finder.video.qq.com/251/20304/stodownload?encfilekey=...",
"video_size": "1048576",
"images": [{
"live_photo_url": "",
"url": "https://finder.video.qq.com/251/20304/stodownload?encfilekey=..."
}],
"media_type": "4", // 4：视频 2：图集
"author": {
"uid": "",
"name": "作者昵称",
"avatar": "https://..."
}
},
"msg": "解析成功"
}响应字段说明
字段除了视频地址, 其他字段可能为空
| 字段名 | 类型 | 说明 |
|---|---|---|
code | int | 状态码，200表示成功 |
msg | string | 状态描述 |
data.mediaUrl | string | 原始媒体URL |
data.urlToken | string | URL令牌 |
data.decode_key | string | 解码密钥 |
data.title | string | 视频标题 |
data.video_url | string | 视频直链URL（或者视频号原加密视频地址，后续将不再提供中转服务） |
data.video_url_v2 | string | 加密视频的URL（奇云去水印或视频号解析，返回的视频URL字段的内容，用于过渡上线） |
data.iteration | int | 视频URL使用标识：1=使用video_url_v2，2=使用video_url |
data.video_size | string | 视频文件大小（字节） |
data.cover_url | string | 视频封面图片URL |
data.images | array | 图片列表（图集类型） |
data.images[].live_photo_url | string | 实况照片URL（暂无） |
data.images[].url | string | 图片URL |
data.author.uid | string | 作者UID |
data.author.name | string | 作者昵称 |
data.author.avatar | string | 作者头像URL |
data.media_type | string | 作品类型 2：图集，4：视频 |
错误码说明
| 错误码 | 说明 | 解决方案 |
|---|---|---|
200 | 成功 | - |
500 | 解析失败，请检查参数是否正确 | 检查Oid和ONid是否正确 |
1001 | 商户平台参数错误 | 检查请求平台appID和AppKey内容 |
1005 | 用户异常 | 商户平台服务账号状态异常，联系客服处理 |
3000 | 未开通视频号解析服务或视频号VIP已过期 | 开通视频号解析服务或续费视频号服务 |
3001 | 请求过于频繁 | 请求过于频繁，请稍后再试或升级更高的套餐 |
3002 | 调用次数不足 | 升级套餐或联系客服 |
3003 | 今日调用次数已达上限 | 升级套餐或联系客服 |
支持平台
专注于视频号平台去水印服务
微信视频号
WeChat Video Account