查询异步图像任务

GET /v1/images/generations/task/{task_id}

查询异步生成或编辑任务的当前状态

请求参数

请求头

Authorization

使用 Bearer Token 认证。格式：Authorization: Bearer sk-xxxxxx

路径参数

路径参数（1 个）

参数	类型	说明	是否必填
`task_id`	string	创建异步任务时返回的任务 ID。	是

请求示例

cURLJavaScriptGoPythonJavaC#

curl "https://10000router.com/v1/images/generations/task/task_xxx" -H "Authorization: Bearer $API_KEY"

const data = await (await fetch("https://10000router.com/v1/images/generations/task/task_xxx", {headers: {Authorization: `Bearer ${process.env.API_KEY}`}})).json();

req, _ := http.NewRequest("GET", "https://10000router.com/v1/images/generations/task/task_xxx", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("API_KEY"))

response = requests.get("https://10000router.com/v1/images/generations/task/task_xxx", headers={"Authorization": f"Bearer {os.environ['API_KEY']}"})

HttpRequest.newBuilder().uri(URI.create("https://10000router.com/v1/images/generations/task/task_xxx")).GET().build();

await httpClient.GetAsync("https://10000router.com/v1/images/generations/task/task_xxx");

返回响应

响应示例

200 成功 400 请求错误 429 请求频率限制 401 未授权

{
  "task_id": "task_xxx",
  "status": "completed",
  "result": {
    "url": "https://example.com/result.png"
  }
}

{
  "error": {
    "message": "任务不存在或已过期",
    "type": "invalid_request_error",
    "param": "task_id",
    "code": null
  }
}

{
  "error": {
    "message": "Rate limit reached",
    "type": "rate_limit_exceeded",
    "param": null,
    "code": null
  }
}

{
  "error": {
    "message": "Invalid authentication credentials",
    "type": "invalid_request_error",
    "param": null,
    "code": null
  }
}

任务响应字段

字段	类型	说明
`task_id`	string	异步任务 ID，用于后续轮询和下载。
`status`	string	任务状态，例如 `queued`、`running`、`completed` 或 `failed`。
`result`	object	任务完成后的结果对象。
`error`	object	任务失败时的执行器错误信息。

任务未完成时按需轮询；如果 status 为 failed，客户端应停止轮询并记录错误，不要无限重试同一个失败任务。

查询异步任务