---
title: "图片生成查询接口"
method: GET
path: "/images/{task_id}"
tags: ["Image"]
---

# 图片生成查询接口

`GET /images/{task_id}`

根据任务ID查询图片生成任务的状态和结果。

## Path parameters

- `task_id` string, uuid, required

## Response `200`

成功响应

- object
  - `model` string, required — 使用的图片模型
  - `task_id` string, uuid, required — 图片任务ID（图片生成接口返回的 task_id 值）
  - `task_status` 'pending' | 'running' | 'succeed' | 'failed', required — 任务状态
  - `data` object[] — 生成的图片列表(仅在task_status=succeed时返回)
    - `url` string, uri, required — 图片URL
    - `b64_json` string, base64 — 图片Base64编码
    - `revised_prompt` string — 优化后的提示文本
  - `error` object — 错误信息(仅在生成失败时返回)
    - `code` string — 错误代码
    - `message` string — 错误描述
    - `details` object — 详细错误信息

## Other responses

- `400` — 参数验证错误
- `401` — 未授权
- `404` — 任务不存在
- `500` — 标准错误响应

---

[API](https://skmtc.dev/geekai/apis/api.md) · [All operations](https://skmtc.dev/geekai/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/geekai/api/revisions/2bf0c8f70a39/schema)