Webhook
通过控制台配置任务通知。每个账户只能配置 一个 HTTPS 回调地址。
配置回调地址
- 登录 Platform,进入 API 管理 → Webhook。
- 配置名称、HTTPS 回调地址及成功 / 失败订阅事件,保存并启用。
- 发送测试事件,检查接收服务及投递记录。测试事件不会创建生成任务或扣除生成积分。
接收与核对
- 任务成功或失败后,Hi3D 向账户配置的地址发送 POST 通知。
- 根据通知中的
task_id核对原任务;接收端需避免同一事件被重复处理。 - 通知不替代查询接口。查询仍可用于核对状态及获取有效下载链接,见异步任务与结果。
- 事件载荷、字段类型、签名校验及确认响应,须按发布的接口契约接入。
投递规则
每个事件最多投递 3 次,含首次投递。
- 首次投递失败后,第 2 次等待 10 秒。
- 第 2 次仍失败时,第 3 次等待 30 秒。
- 任一次投递成功后,停止重试。
最终未收到通知时,使用原 task_id 查询任务。
投递记录包含事件 ID、任务 ID、事件、投递时间、投递状态和 HTTP 状态。
从旧请求迁移
已有集成请从创建任务请求中移除 callback_url,并在控制台启用账户级 Webhook。
适用范围
支持图生3D、图生浮雕、图生刺绣、贴图、拆件和多色的任务通知。