查询图片任务

异步任务（极点扩展）

在原有请求中加入 "async": true，服务器将先返回 HTTP 202 和 task_id。
随后使用同一个极点账号的有效 API Key 查询 GET /v1/images/generations/{task_id}。
图生图任务也可通过 GET /v1/images/edits/{task_id} 查询，两条查询地址等价。
未传 async 或传 false 时保持同步返回图片。该任务协议是极点扩展，不能假定其他 OpenAI 兼容站支持。

JSON 使用布尔值；文件上传可以添加文本字段 async=true，也可设置 X-Async: true 或 ?async=true。
多个位置的 async 值必须一致。异步与 stream 不能同时开启。图片、size、n 等原有参数不变。

提交示例

{"model":"gpt-image-2","prompt":"画一只橘猫","size":"1024x1024","n":1,"async":true}

返回示例：{"task_id":"task_example","id":"task_example","status":"queued","model":"gpt-image-2","created_at":1791129600}。
响应的 Location 头给出查询路径。建议每 3–5 秒查询一次。

状态与结果

status	含义	下游处理
queued	请求已持久化，等待执行	继续查询
in_progress	后台正在执行	继续查询
completed	已取得图片结果	读取 data[].url 或 data[].b64_json
failed	请求明确失败	读取 error；修正后再提交
unknown	任务执行结果无法确认	停止轮询，提供 task_id 联系支持核对，勿自动重新提交

查询成功返回 HTTP 200；任务失败也通过 status/error 表达，不能只检查 HTTP 状态码。
查询接口仅允许任务所属账号访问。成功结果保留上游图片字段，并增加任务 ID、状态与时间戳。
图片链接可能过期，收到结果后应及时下载；保存任务记录不等于永久保存图片文件。

重复请求、费用与限制

建议提交时设置 Idempotency-Key（最多 128 字节）。同一账号、同一 API Key、同一标识和相同请求返回同一任务，不再次排队；改了请求仍用旧标识会返回 409。

重试时必须保留相同的路径、查询参数、Content-Type 和移除 async 后的请求体字节。重新序列化 JSON、改变 multipart boundary 都可能产生 409；请保存原始请求，或者拿到 task_id 后只查询。

HTTP 202 表示已接收，不保证一定成功。实际执行时重新检查密钥、模型、渠道和余额，并沿用同步图片接口计费；查询本身不触发图片生成。

默认并行执行 2 个图片任务；每账号最多 16 个待处理任务；全站约 128 个的入队上限，达到限制返回 429。管理员可以调整。

异步请求体和响应体各最多 64 MiB，执行超时为 10 分钟。排队时间不计入执行超时。多图 Base64 的体积也计入请求上限。

排队中的任务可以在服务重启后继续处理。已经发往上游但无法确认结果的任务进入 unknown，不盲目重发，避免重复消费。

当前版本使用轮询，不支持 callback_url/Webhook，提交非空 callback_url 会返回 400。视频继续使用所接渠道支持的原生异步接口，不能套用本图片查询路径。

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

application/json

任务当前状态；completed 时附带图片结果。

Bodyapplication/json

示例

等待执行生成完成执行失败需人工核对

{
    "task_id": "task_example",
    "id": "task_example",
    "status": "queued",
    "created_at": 1791129600
}

查询图片任务

异步任务（极点扩展）

提交示例

状态与结果

重复请求、费用与限制

请求参数

请求示例代码

返回响应

查询图片任务

异步任务（极点扩展）#

提交示例#

状态与结果#

重复请求、费用与限制#

请求参数

请求示例代码

返回响应

异步任务（极点扩展）

提交示例

状态与结果

重复请求、费用与限制