需配置百度一镜webhook接收视频生成完成通知,要求url支持post并返回200,启用签名验证并配置密钥,服务端须校验时间戳与hmac-sha256签名后解析video_url。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要在数字人视频生成任务完成后,立刻收到通知并自动触发后续动作,比如把视频发到企业微信、存进云盘或推流到直播间。
确认Webhook接收端已就绪
先确保你有一个能接收HTTP POST请求的服务地址——它可以是内网调试用的RequestBin链接,也可以是部署在公网的Node.js/Python接口,或者直接填钉钉/企微机器人Webhook URL。注意:【该URL必须支持POST方法,且能稳定响应200状态码,否则百度一镜会判定推送失败并停止重试】。
如果你用的是钉钉机器人,需提前在群设置里开通自定义机器人,复制“Webhook地址”;如果是自建服务,确保路由路径如/webhook/baidu-yijing已存在并能解析JSON体。
进入百度一镜控制台配置推送
登录百度一镜数字人平台 → 点击右上角头像 → 进入「账号设置」→ 选择「Webhook管理」标签页。
点击「新建推送规则」→ 在「事件类型」下拉框中选择「视频生成完成」(注意不是「任务提交成功」或「渲染中」)。
在「目标URL」栏粘贴你准备好的接收地址;勾选「启用签名验证」——这一步必须开启,否则百度一镜不会发送X-Baidu-Signature和X-Baidu-Timestamp头部。
填写「密钥」:该密钥由你自行设定,仅用于服务端验签,需与你后端代码中配置的密钥完全一致;保存时系统会自动生成一个push_id,这个ID将随每次推送一同下发,可用于幂等去重。
调用百度PaddleOCR‑VL大模型API,支持PDF、Word、PPT、图片等多格式文档解析,精准识别印刷体、手写体、表格、公式、图表、印章等复杂元素,支持100+语言,可处理不规则布局和跨页长文档。触发词:文档解析、VLM解析、大模型OCR、PaddleOCR、多模态文档、手写识别、公式识别、复杂版面。
验证推送是否生效
方法一:提交一条测试视频生成任务(可用最简脚本:“你好”),等待状态变为「已完成」。
方法二:在「Webhook管理」页点击对应规则右侧的「手动触发测试」按钮,平台会立即向你的URL发送一条结构化模拟数据,含event_type、video_url、task_id、duration_ms等字段。
若接收端日志中出现含"event_type":"video_generate_success"的请求,且响应状态码为200,则说明通道已通。注意:【测试请求不携带真实视频文件,仅含元数据;正式生成的视频URL为直链,有效期7天,请及时下载或转存】。
服务端验签与解析(关键步骤)
第一步:从HTTP Header中提取X-Baidu-Timestamp和X-Baidu-Signature两个字段。
第二步:取当前时间戳(毫秒级),与X-Baidu-Timestamp做差值判断是否超5分钟——超过则拒绝,防止重放攻击。
第三步:拼接待签名字符串:timestamp={X-Baidu-Timestamp}&body={原始请求体JSON字符串},使用你在控制台填写的密钥,通过HMAC-SHA256算法生成摘要,再Base64编码。
第四步:将生成的签名字符串与X-Baidu-Signature逐字符比对,完全一致才解析video_url并执行业务逻辑。










