Webhooks

Live
通过签名、重试和投递日志接收 Prediction 终态事件。
在 ChatGPT 中打开
(opens in new tab)
最后核对: 2026-08-11

注册 Endpoint

调用 POST /webhooks/endpoints,传入公开 HTTPS URL。返回的 Signing Secret 只展示一次,请立即保存。GET /predictions/:id 轮询始终保留,是投递延迟时的恢复路径。

验签与去重

读取原始 Body,把 x-modelrush-signature 解析为 t=TIMESTAMP,v1=HMAC,拒绝过期时间戳,并用常量时间比较 HMAC-SHA256。按 x-modelrush-event-id 去重;投递为至少一次,因此 Handler 必须幂等。

重试与日志

ModelRush 使用 10 秒超时与指数退避,最多尝试八次,之后进入 Dead Letter。通过 GET /webhooks/deliveries 查看日志;用 POST /webhooks/deliveries/:id/retry 重试 Failed/Dead Letter 事件。手动重试绝不会重新执行模型任务。