需配置百度一镜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并执行业务逻辑。
