获取图像生成任务

查询异步图片生成任务。仅当创建图像接口返回 object: "image.generation.task" 时需要调用。

Try It

GET/v1/images/generations/{task_id}https://api-platform.ope.ai

认证

使用 Bearer Token 认证。

• Header：Authorization: Bearer <token>
• 示例：Authorization: Bearer sk-xxxxxx

Path 参数

参数	类型	必填	说明
task_id	string	是	创建图像接口返回的任务 ID

任务状态

状态	说明
QUEUED	任务已创建，等待后台执行
IN_PROGRESS	后台正在请求上游生成图像
SUCCESS	生成成功，可读取 data[]
FAILURE	生成失败，查看 fail_reason

成功任务的 expires_at 为 finish_time + 24 小时。超过保留时间后再次查询会返回 image_task_expired。

请求示例

下方域名为示例：https://api-platform.ope.ai。

cURL

curl -X GET "https://api-platform.ope.ai/v1/images/generations/image_2f9b9a3d8c1e4f5a6b7c8d9e" \
  -H "Authorization: Bearer $OPEAI_API_KEY"

JavaScript

const apiKey = process.env.OPEAI_API_KEY;
const taskId = "image_2f9b9a3d8c1e4f5a6b7c8d9e";
const url = `https://api-platform.ope.ai/v1/images/generations/${taskId}`;

const res = await fetch(url, {
  method: "GET",
  headers: { Authorization: `Bearer ${apiKey}` },
});

console.log(await res.json());

Go

package main

import (
  "fmt"
  "net/http"
  "os"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api-platform.ope.ai/v1/images/generations/image_2f9b9a3d8c1e4f5a6b7c8d9e", nil)
  req.Header.Set("Authorization", "Bearer "+os.Getenv("OPEAI_API_KEY"))

  resp, err := http.DefaultClient.Do(req)
  if err != nil {
    panic(err)
  }
  defer resp.Body.Close()
  fmt.Println(resp.Status)
}

Python

import os
import requests

resp = requests.get(
  "https://api-platform.ope.ai/v1/images/generations/image_2f9b9a3d8c1e4f5a6b7c8d9e",
  headers={"Authorization": f"Bearer {os.environ.get('OPEAI_API_KEY')}"},
  timeout=60,
)

print(resp.json())

响应示例

排队中

{
  "id": "image_2f9b9a3d8c1e4f5a6b7c8d9e",
  "task_id": "image_2f9b9a3d8c1e4f5a6b7c8d9e",
  "object": "image.generation.task",
  "status": "QUEUED",
  "created_at": 1777440000,
  "finish_time": 0,
  "expires_at": 0,
  "model": "gpt-image-2",
  "prompt": "生成展示AI生图能力的图文。",
  "size": "1024x1024",
  "quality": "auto",
  "mode": "generation",
  "fail_reason": ""
}

成功

{
  "id": "image_2f9b9a3d8c1e4f5a6b7c8d9e",
  "task_id": "image_2f9b9a3d8c1e4f5a6b7c8d9e",
  "object": "image.generation.task",
  "status": "SUCCESS",
  "created_at": 1777440000,
  "finish_time": 1777440180,
  "expires_at": 1777526580,
  "model": "gpt-image-2",
  "prompt": "生成展示AI生图能力的图文。",
  "size": "1024x1024",
  "quality": "auto",
  "mode": "generation",
  "fail_reason": "",
  "data": [
    {
      "url": "https://example.com/generated-image.png",
      "b64_json": ""
    }
  ],
  "usage": {
    "generated_images": 1,
    "total_tokens": 100
  }
}

失败

{
  "id": "image_2f9b9a3d8c1e4f5a6b7c8d9e",
  "task_id": "image_2f9b9a3d8c1e4f5a6b7c8d9e",
  "object": "image.generation.task",
  "status": "FAILURE",
  "created_at": 1777440000,
  "finish_time": 1777440180,
  "expires_at": 0,
  "model": "gpt-image-2",
  "prompt": "生成展示AI生图能力的图文。",
  "size": "1024x1024",
  "quality": "auto",
  "mode": "generation",
  "fail_reason": "upstream timeout"
}

过期/不存在

{
  "error": {
    "message": "image task result expired",
    "type": "not_found",
    "code": "image_task_expired"
  }
}