Skip to main content

任务生命周期

任务状态

提交任务

轮询状态

请求内等待(Prefer: wait)

不想手动轮询时,提交任务带 Prefer: wait=N 请求头(N ≤ 60 秒):
  • 窗口内完成 → 直接返回终态完整结果(含 resultcost
  • 超窗未完成 → 返回当前状态,继续用 GET /v1/tasks/{task_id} 轮询

计费与退款

价格未配置的模型会在提交时直接拒绝(HTTP 500,code: price_not_configured), 不会出现”提交成功但乱扣费”的情况。

Webhook 回调

提交任务时设置 callback_url,任务完成后 清波 API 会主动推送结果:

取消任务

只有 queued 状态的任务可以取消,取消后配额自动退还:
生成结果中的图片/视频 URL 有有效期,请及时下载保存。