异步任务与结果
生成任务采用异步方式。获取 Token 后提交任务,保存 task_id,再查询结果;全部任务端点均可使用控制台账户级 Webhook 接收通知。
- 获取 Token
- 提交任务并保存
task_id - 查询状态 / 接收回调
- 成功后保存结果文件
API任务状态
data.state | 含义 | 处理方式 |
|---|---|---|
created | 创建成功 | 保留 task_id 并继续查询 |
queueing | 排队中 | 等待处理 |
processing | 处理中 | 继续查询或等待回调 |
success | 成功 | 读取 url 和适用的 cover_url,及时下载 |
failed | 失败 | 检查错误与退回记录,修正输入后再决定是否重提 |
查询与回调
- 主动查询:按任务类型选择查询路径,传入创建时返回的
task_id。 - 接收通知:在控制台配置账户级 Webhook,接收成功或失败通知。通知未到时可继续查询。
- 请求超时:先查原
task_id的状态,避免重复提交。
结果与计费
- 结果链接:成功后读取
data.url和适用的data.cover_url。结果文件和效果图链接均有效 1 小时。 - 链接过期:用原
task_id重新查询。下载时请保留完整签名 URL。 - 积分消耗:提交成功后扣除积分,失败后返还。以任务记录中的实际扣退为准,历史任务按原记录核对。
技术支持:apicontact@hi3d.ai