查询任务

使用该接口轮询任务，直到任务状态变为 success 或 fail。

Endpoint

GET /api/v1/jobs/recordInfo?taskId=task_xxx

Headers

Authorization: Bearer sk-your-api-key

示例

curl "https://aigptimage.com/api/v1/jobs/recordInfo?taskId=task_xxx" \
  -H "Authorization: Bearer sk-your-api-key"

响应示例

任务仍在处理中：

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "5064bd1a-025a-490b-b28f-6a9fa12eb88a",
    "model": "gpt-image-2-text-to-image",
    "state": "waiting",
    "param": "{\"model\":\"gpt-image-2-text-to-image\",\"input\":{\"prompt\":\"A cinematic portrait of a robot painter\"}}",
    "resultJson": null,
    "failCode": null,
    "failMsg": null,
    "costTime": null,
    "completeTime": null,
    "createTime": 1777474689024
  }
}

任务成功：

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_xxx",
    "model": "gpt-image-2-text-to-image",
    "state": "success",
    "param": "{\"model\":\"gpt-image-2-text-to-image\",\"input\":{\"prompt\":\"A cat\"}}",
    "resultJson": "{\"resultUrls\":[\"https://cdn.example.com/result.png\"]}",
    "failCode": null,
    "failMsg": null,
    "costTime": 32241,
    "completeTime": 1777460000000,
    "createTime": 1777459967759
  }
}

任务失败：

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "5f6ff8ea-ae97-4bb8-af5e-752ef4e96c0d",
    "model": "gpt-image-2-text-to-image",
    "state": "fail",
    "param": "{\"model\":\"gpt-image-2-text-to-image\",\"input\":{\"prompt\":\"360 equirectangular panorama, first-person view standing on stage at a massive concert with Michael Jackson performing, huge crowd cheering with hands raised, bright stage lights, smoke, dramatic spotlight, ultra realistic, cinematic concert atmosphere, immersive perspective, high detail, 2:1 aspect ratio, 4096x2048, no distortion\"}}",
    "resultJson": null,
    "failCode": "400",
    "failMsg": "Sorry, but the image we created may violate OpenAI's content policies.",
    "costTime": null,
    "completeTime": null,
    "createTime": 1777475010433
  }
}

状态

State	含义
`waiting`	等待中或处理中
`success`	任务成功
`fail`	任务失败或取消

返回字段

字段	类型	说明
`data.taskId`	`string`	任务 ID
`data.model`	`string`	对外模型 ID
`data.state`	`string`	任务状态：`waiting`、`success`、`fail`
`data.param`	`string`	原始创建任务参数，JSON 字符串
`data.resultJson`	`string \| null`	任务结果 JSON 字符串。成功时通常包含 `resultUrls`
`data.failCode`	`string \| null`	任务失败时的错误码
`data.failMsg`	`string \| null`	任务失败时的错误信息
`data.costTime`	`integer \| null`	任务完成后的耗时，单位毫秒
`data.completeTime`	`integer \| null`	完成时间戳，单位毫秒
`data.createTime`	`integer`	创建时间戳，单位毫秒

结果格式

当 state 为 success 时，resultJson 是一个 JSON 字符串：

{
  "resultUrls": ["https://cdn.example.com/result.png"]
}

当 state 为 fail 时，请重点看：

failCode：失败任务对应的平台错误码
failMsg：可读的失败原因

也就是说，HTTP 请求本身仍然可能返回 200，但任务本身已经失败。最终结果必须以 data.state 为准。

查询任务

Endpoint

Headers

示例

响应示例

状态

返回字段

结果格式

On this page