任务生命周期
任务状态
提交任务
轮询状态
请求内等待(Prefer: wait)
不想手动轮询时,提交任务带Prefer: wait=N 请求头(N ≤ 60 秒):
- 窗口内完成 → 直接返回终态完整结果(含
result与cost) - 超窗未完成 → 返回当前状态,继续用
GET /v1/tasks/{task_id}轮询
计费与退款
价格未配置的模型会在提交时直接拒绝(HTTP 500,
code: price_not_configured),
不会出现”提交成功但乱扣费”的情况。
Webhook 回调
提交任务时设置callback_url,任务完成后 清波 API 会主动推送结果:
取消任务
只有queued 状态的任务可以取消,取消后配额自动退还:
生成结果中的图片/视频 URL 有有效期,请及时下载保存。