Wechat-Channels-V2/微信视频号V2

微信视频号视频详情

POST

https://api.getoneapi.com/api/wechat-channels-v2/fetch_video_detail

获取视频号作品详情，返回作品完整详情（媒体地址 media + decode_key）。
支持三种入参，三选一、优先级 object_id > export_id > share_url。

由于微信服务器原因，本接口响应较慢，请将客户端请求超时（timeout）设置为 30 秒；timeout 设置过小会造成已扣费但收不到响应的情况。

重要提示（视频下载与解密）:

直接访问响应里的 url 无法打开视频页面，因为微信视频号做了防盗链加密。把 url 和 url_token 拼成完整 URL（或直接使用full_url）再用任意 HTTP 客户端下载（能打开 = HTTP 200，不代表能播放，文件是加密的）。
⚠️ 视频文件加密说明: 下载的 MP4 若无法播放即为加密文件。请使用接口返回的 decode_key 字段和加密视频文件进行解密。
⚠️ 重要: 微信每次请求都返回新的加密链接和 decode_key（即使同一视频）。务必保证 decode_key 与下载的加密文件来自同一次 API 响应，否则解密失败。

免费在线解密工具: https://wc.getoneapi.com/

请求参数

Header 参数

Authorization string 必需

在 Header 添加参数 Authorization，其值为在 Bearer 之后拼接 apikey

默认值： Bearer YOUR_API_KEY

Content-Type string 必需

默认值： application/json

Body 参数

application/json

object_id string 可选

最优先，可选。作品 objectId（纯数字），示例 14943822173652851063。可从 fetch_user_video_list 的视频 id 获取。

export_id string 可选

其次，可选。搜索结果里的 exportId（须以 export/ 开头）。搜索返回的视频项往往只有 exportId、没有明文 object_id —— 此时直接传 export_id（会过期，需尽快用）。

object_nonce_id string 可选

可选。搜索结果里的 feedNonceId（纯数字），搭配上面两者提升命中率。

share_url string 可选

最后，可选。视频号分享短链（https://weixin.qq.com/sph/…），示例 https://weixin.qq.com/sph/AAlmZdGH7b。仅在 object_id 与 export_id 都为空时使用。

raw boolean 可选

可选，默认 false。true=原始；false=精简解析。

示例

{
  "object_id" : "14943822173652851063",
  "export_id" : "",
  "object_nonce_id" : "",
  "share_url" : "",
  "raw" : false
}

返回响应

响应 200

application/json

code integer 必需

message string 必需

data object 必需

示例

{
  "code" : 200,
  "message" : "success",
  "data" : { }
}

请求示例代码

替换 YOUR_API_KEY、参数占位符与请求数据后使用。第三方客户端需先安装对应依赖。

curl --globoff --request POST 'https://api.getoneapi.com/api/wechat-channels-v2/fetch_video_detail' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "object_id" : "14943822173652851063",
  "export_id" : "",
  "object_nonce_id" : "",
  "share_url" : "",
  "raw" : false
}'

更新于 2026-11-10 19:04:48