ONEAPI / wechat-channels

微信视频号 API

围绕视频号作品与账号资料构建内容流程。Wechat-Channels-V2 文档提供视频详情、作品列表、评论、合集及直播相关端点；视频媒体地址与解密信息需按同一次响应配对处理。

查看平台文档注册并创建 API 密钥

01 / CAPABILITIES

可接入的能力

作品详情与媒体信息

获取视频号作品详情，包括文档说明的 media 与 decode_key。

端点文档 →

账号作品列表

读取账号的作品列表，账号资料与统计使用其他对应端点。

端点文档 →

评论与合集

读取作品评论；合集列表与合集内视频也有专用文档。

端点文档 →

02 / USE CASES

可以构建什么

视频号作品管理

将账号作品列表与视频详情结合，整理作品和合集信息。

媒体处理流程

按文档处理媒体链接与 decode_key，连接视频下载与解密步骤。

03 / REQUEST EXAMPLE

通过 object_id 查询视频号作品

将 YOUR_OBJECT_ID 替换为实际作品标识。文档支持 object_id、export_id、share_url 三选一，优先级依次降低，并建议客户端超时设置为 30 秒。

cURLPOST · JSON

curl --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" : "YOUR_OBJECT_ID",
  "export_id" : "",
  "object_nonce_id" : "",
  "share_url" : "",
  "raw" : false
}'

将 YOUR_API_KEY 与示例中的内容标识替换为实际值。示例为 cURL（Shell 语法）；可在 Apifox 文档切换到 Windows、Python 等代码示例。实际请求会按账户配置计费。

查看完整参数与响应说明 →

04 / FAQ

常见问题

为什么返回的媒体 URL 下载后可能无法直接播放？

视频号媒体可能是加密文件。按文档拼接 url 与 url_token，或使用 full_url 下载，再使用同一次响应中的 decode_key 处理加密文件。

同一视频可以混用不同请求返回的 decode_key 吗？

不可以。文档说明每次请求可能生成新的加密链接与 decode_key。下载的文件和密钥必须来自同一次响应，否则可能解密失败。