GlobalAiOpc

GPT Image 2 - 查询任务

查询 GPT Image 2 图片生成任务的状态和结果

GET/kyyReactApiServer/v1/result/{id}

查询图片生成任务

使用任务 ID 查询 GPT Image 2 图片生成任务的状态和结果。
所有请求都需要在请求头中包含 Bearer token:
cURL
Authorization: Bearer {{key}}

基础 URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址,请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。

路径参数

idstring必填
图片生成任务的唯一标识符,从创建任务接口返回

响应参数

idstring
图片生成任务的唯一标识符
objectstring
对象类型,固定为 image.generation
createdinteger
任务创建时间戳
modelstring
使用的模型名称
statusstring
任务状态:
  • queued - 排队中
  • processing - 处理中
  • completed - 已完成
  • failed - 失败
image_urlstring
生成的图片URL,当 status 为 completed 时返回
errorstring
错误信息,当 status 为 failed 时返回

状态流程

queued

任务已创建并加入队列,等待处理

processing

任务正在处理中,AI 模型正在生成图片

completed

任务完成,图片生成成功,可通过 image_url 获取结果

轮询建议

轮询策略:
  • 建议轮询间隔:2-5 秒
  • 避免过于频繁的请求以免触发限流
  • 当状态为 completedfailed 时停止轮询

图片URL说明

重要提示:
  • 生成的图片URL有效期通常为 24 小时
  • 请及时下载并保存图片到你的存储系统
  • URL 过期后将无法访问图片