1. image-2异步接口
OpenAI-Hub接口文档
  • image-2异步接口
    • 8.23下线·提交图片编辑(异步)
      POST
    • 8.23下线 提交图片生成(异步)
      POST
    • 8.23下线 查询任务结果(异步)
      GET
    • 8.23下线 图片直链(异步)
      GET
    • 提交生图任务(异步)
      POST
    • 提交图片编辑任务(异步)
      POST
    • 查询异步任务
      GET
AI模型接口图片异步提交
后台管理接口
AI模型接口图片异步提交
后台管理接口
  1. image-2异步接口

查询异步任务

GET
/v1/images/async/{task_id}
主站原生异步接口,替代旧 image-2 Cloudflare Worker 的 /result。
用提交接口返回的 task_id 轮询任务状态与结果。
鉴权:必须带 Authorization: Bearer <apikey>,且只能查自己的任务(与旧 worker 裸 task_id 可查不同)。
status 流转:queued → in_progress → succeeded | failed(终态不再变)。
succeeded:结果图在 result.images(对象存储公网直链数组,<img> 可直接引用,保留 10 天)。
failed:失败原因在 error。
注意:查不存在的任务、查别人的任务都返回 404「任务不存在」(不泄露任务存在性)。建议轮询间隔 2~5 秒;查询不占模型限流额度。

请求参数

Path 参数

Header 参数

返回响应

🟢200成功
application/json
Bodyapplication/json

🟠404任务不存在或不属于当前 key
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.openai-hub.net/v1/images/async/task_puOoOgerd3y1alVRfpFfJLYIiutF9lLA' \
--header 'Authorization: Bearer sk-0ABIEXVjh9****Qckjy'
响应示例响应示例
200 - 示例 1
{
    "task_id": "string",
    "status": "string",
    "result": {
        "images": [
            "string"
        ]
    },
    "error": "string"
}
上一页
提交图片编辑任务(异步)
Built with