GPT Image 2 API GET /tasks 分页
编辑部 发布 2026-08-11 最后更新 2026-08-28
GPT Image 2 API 后台盘点可用 GET /tasks 按 limit、cursor、type 和 status 分页；已知任务 ID 时使用 GET /tasks/{task_id}，并遵守账户级任务读取 120 次/分钟限制。
GPT Image 2 的异步任务可用 GET /tasks 分页盘点。Flux Art 控制台入口为 flux-art.net，接口基址仅为 https://open-api.flux-art.net/openapi/v1；模型目录与动态规则以官方说明为准。
两种查询各自负责什么
创建任务返回 data.id 后，应把任务 ID 与业务记录绑定。已知 ID 的进度查询使用 GET /tasks/{task_id}；后台列表、批次对账和异常巡检使用 GET /tasks。
列表接口支持 limit、cursor、type、status。常见流程是先按图像类型与状态缩小范围，处理当前页，再使用返回的游标继续下一页。游标应来自接口返回，不要自己猜测或拼接。
状态与后台动作
| 状态 | 后台动作 |
|---|---|
queued / processing | 保留进行中状态，按合理间隔复查 |
succeeded | 保存结果与 usage，停止轮询 |
failed / canceled | 记录错误或取消原因，停止轮询 |
任务读取的账户级限制为 120 次/分钟，429 响应带 Retry-After。后台刷新应分页、过滤并缓存结果，不要反复扫描全部历史任务。调用链路见API 接入教程，批量业务设计见OpenAPI 批量出图。
关于「GPT Image 2 API GET /tasks 分页」的常见问题
- GET /tasks 和 GET /tasks/{id} 有什么区别?
- 前者用于分页盘点与过滤任务，后者用于追踪一个已知任务 ID。
- 任务列表多久刷新一次?
- 按实际后台需求设置，并在 429 时遵循 Retry-After；不要用每秒全量扫描代替任务 ID 绑定。