Images Task 图片任务查询

用于查询图片生成任务的执行状态。由于图片生成采用异步模式，客户端提交生成请求后会获得一个 task_id，需要通过本接口轮询查询，直到任务完成并获取最终图片 URL。

请求头 Headers

请求参数

请求示例

GET /api/openai/imagesTask?id=15
Authorization: Bearer sk-xxxxxxxx

任务进行中

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": 15,
    "status": "pending"
  }
}

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": 15,
    "status": "running"
  }
}

任务成功

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": 15,
    "status": "success",
    "url": "https://cdn.example.com/images/20260813/xxxx.png",
    "quantity": 1,
    "cost": 0.40
  }
}

任务失败

{
  "code": 500,
  "msg": "Image generate failed",
  "data": {
    "task_id": 15,
    "status": "failed"
  }
}

状态码说明

JavaScript 轮询示例

const taskId = 15;
const timer = setInterval(async () => {
  try {
    const res = await fetch(
      `/api/openai/imagesTask?id=${taskId}`,
      {
        headers: {
          Authorization: "Bearer sk-xxxxxxxx",
        },
      }
    );
    const result = await res.json();

    if (result.code === 200) {
      const { status, url, cost } = result.data;

      if (status === "success") {
        clearInterval(timer);
        console.log("图片地址:", url);
        console.log("本次消耗:", cost, "元");
        displayImage(url);
      } else if (status === "failed") {
        clearInterval(timer);
        console.error("生成失败");
      }
    } else {
      clearInterval(timer);
      console.error("查询失败:", result.msg);
    }
  } catch (err) {
    console.error("网络错误:", err);
  }
}, 2500);

function displayImage(url) {
  const img = document.createElement("img");
  img.src = url;
  document.body.appendChild(img);
}

建议轮询间隔为 2~3 秒，任务成功或失败后应立即停止轮询，避免不必要的资源消耗。图片生成通常需要 10~60 秒，具体取决于模型复杂度和服务器负载。

完整流程

步骤 1：创建图片生成任务
POST /api/openai/imagesGenerations
{ "model": "wanx2.1-t2i-turbo", "prompt": "..." }

        ↓

步骤 2：返回任务 ID
{ "code": 200, "data": { "task_id": 15, "status": "pending" } }

        ↓

步骤 3：轮询任务状态（每 2~3 秒）
GET /api/openai/imagesTask?id=15

        ↓

        running  ←  继续轮询
        running  ←  继续轮询

        ↓

步骤 4：任务成功
{ "code": 200, "data": { "status": "success", "url": "https://...", "cost": 0.40 } }

        ↓

步骤 5：获取图片 URL，展示给用户

错误码

错误返回示例

{ "code": 400, "msg": "Parameter id is required" }
{ "code": 401, "msg": "Invalid API Key" }
{ "code": 404, "msg": "Task not found" }
{ "code": 500, "msg": "Image generate failed" }

注意事项