跳转到主要内容
通过 GET /v1/tasks/{task_id} 查询当前账户的异步任务。 提交任务后,保存返回的任务 ID 和 request_id。

状态值

  • pending
  • processing
  • completed
  • failed
  • expired
terminal 为 false 时,按 retry_after_ms 指示等待,再查询同一个任务 ID。 客户端轮询达到等待上限时,保存 ID,稍后恢复查询。 提交超时且未收到 ID 时,参阅媒体任务超时处理。

成功任务

result 的结构取决于任务类型。 图片任务返回 OpenAI 图片格式——图片地址在 result.data[0].url:
视频与音频任务的主地址在 result.video_url / result.audio_url,全部产物也会列在 result.urls[] 中:

失败任务

最终任务响应会包含 credits.reserved 和 credits.charged。 前者是初始预留积分,通过后者核对最终扣费。失败任务的处理规则参阅计费说明。 通过 Webhook 回调 接收任务通知。