微信视频号素材 API 文档 · 试用

POST /v1/ecom/wechat-channels/download:传入真实微信视频号分享或显式作品 ID,视频准备完成后返回 MP4 下载地址(48 小时有效)、封面与作品信息。

微信视频号素材试用

推荐使用真实 https://weixin.qq.com/sph/ 分享链接或完整文案,保留全部查询参数。微信卡片、标题、截图与普通数字不能代替作品分享。

POST /v1/ecom/wechat-channels 与 POST /v1/ecom/wechat-channels/download 解析作品并准备可下载视频。统一 /v1/ecom/product 也能自动识别有效分享或显式 object_id/export_id;可选 platform=wechat_channels 明确指定平台。

请求参数

使用 url、object_id、export_id 其中一种。object_id 为真实作品数字字符串,较长数字请保持字符串避免失真;export_id 保留 export/ 前缀。推荐优先使用完整分享链接。

鉴权与计费

需 Authorization: Bearer API_KEY;所有平台统一成功 ¥0.02/次,失败不扣费。复用有效结果不重复扣费,新操作成功时计费;以 billed/replayed 为准。相同幂等键成功后 24 小时内可重放,未传键时相同参数 10 分钟内自动复用有效结果;视频复用不超过下载地址有效期。

等待与下载

视频准备可能需要数分钟,建议客户端超时至少 300 秒。只有准备好可用视频才返回成功;成功返回 download_url、expires_at 和 product。转存视频下载地址保留 48 小时,封面等原始图片不承诺这一有效期。

product.platform 为 wechat_channels;可用字段包括标题、封面 main_images、作者 author、object_id 与视频。具体字段以实际作品为准。试用期间不保证所有作品均可获取。

MCP 接入

get_wechat_channels_material 接受真实分享 url 或显式 object_id、export_id,自动准备可下载视频;统一 get_product_material 也支持分享识别。

微信视频号素材介绍 · 试用控制台 · 价格