跳轉到主要內容
ToAPIs 對非同步圖片與影片發送 generation.completedgeneration.failed,測試事件為 endpoint.test。投遞至少一次;重試保留相同 event ID,請以 id 冪等去重。 在控制台編輯 Token,設定 HTTPS 預設 URL、產生僅顯示一次的 32-byte 密鑰、啟用並測試。請求未帶 callback_url 時使用預設 URL;覆蓋 URL 只能更改同協議、同網域、同連接埠的路徑與 query。未設定時返回 400 webhook_not_configured
最終失敗只會在內部重試結束、退款或計費完成後發送:
控制台測試使用相同簽名協議:
task_typeimage|video。結果與公開任務查詢一致;不返回渠道 ID、上游 task ID/密鑰、憑證或 PrivateData。
簽名原文:event_id + "." + timestamp + "." + raw_request_body;HMAC-SHA256。首次投遞拒絕超過 5 分鐘的時間戳。輪換後 24 小時同時驗證新舊密鑰。
Python
Node.js
Go
首次投遞立即執行;失敗後約於 10秒、30秒、2分鐘、10分鐘、1小時、6小時、24小時重試。僅 2xx 成功;3xx 不跟隨,4xx/5xx 會重試,HTTP 逾時為 10 秒。HTTPS、userinfo、fragment、非法 port、SSRF、DNS/IP 與 DNS rebinding 防護會在每次投遞重新驗證。回調失敗以任務查詢兜底,結果 URL 可能過期,請及時保存。真人認證、支付與 OAuth callback 不受影響。參閱 限流