> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keevx.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 查看图片创作任务结果

> 根据任务 ID 查询单个图片生成子任务的当前状态和结果。



## OpenAPI

````yaml GET /v1/image_generate/{task_id}
openapi: 3.1.1
info:
  title: Keevx API
  description: Keevx AI API，提供图片生成、图生视频和视频翻译服务。
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.keevx.cn/
security:
  - bearerAuth: []
paths:
  /v1/image_generate/{task_id}:
    get:
      summary: 查询图片生成任务状态
      description: 根据任务 ID 查询单个图片生成子任务的当前状态和结果。
      operationId: getImageGenerateStatus
      parameters:
        - name: task_id
          in: path
          required: true
          schema:
            type: string
          description: 提交接口返回的子图片任务 ID（`task_ids` 数组中的一个元素）。
      responses:
        '200':
          description: 查询结果返回。
          content:
            application/json:
              schema:
                oneOf:
                  - allOf:
                      - $ref: '#/components/schemas/BaseResponse'
                      - type: object
                        properties:
                          data:
                            $ref: '#/components/schemas/ImageGenerateInfo'
                  - $ref: '#/components/schemas/BaseResponse'
              examples:
                generating:
                  summary: 生成中
                  value:
                    code: 0
                    msg: ok
                    data:
                      task_id: i2is-a1b2c3d4e5f6
                      status: GENERATING
                      image_url: ''
                      thumbnail_url: ''
                      error_message: ''
                succeeded:
                  summary: 生成成功
                  value:
                    code: 0
                    msg: ok
                    data:
                      task_id: i2is-a1b2c3d4e5f6
                      status: SUCCEEDED
                      image_url: https://storage.example.com/generated.png
                      thumbnail_url: https://storage.example.com/thumb.webp
                      error_message: ''
                failed:
                  summary: 生成失败
                  value:
                    code: 0
                    msg: ok
                    data:
                      task_id: i2is-a1b2c3d4e5f6
                      status: FAILED
                      image_url: ''
                      thumbnail_url: ''
                      error_message: Image generation failed due to content policy
                notFound:
                  summary: 任务未找到 (code 110002)
                  value:
                    code: 110002
                    msg: image not found
components:
  schemas:
    BaseResponse:
      type: object
      required:
        - code
        - msg
      properties:
        code:
          type: integer
          description: 业务状态码。`0` 表示成功；非零表示错误。
        msg:
          type: string
          description: 状态消息。成功时为 `ok`；失败时为错误描述。
        data:
          description: 业务数据。错误响应时省略或为 null。
    ImageGenerateInfo:
      type: object
      required:
        - task_id
        - status
      properties:
        task_id:
          type: string
          description: 子图片任务 ID。
        status:
          type: string
          enum:
            - GENERATING
            - SUCCEEDED
            - FAILED
          description: 当前任务状态。
        image_url:
          type: string
          description: 生成图片的 URL。仅当状态为 `SUCCEEDED` 时返回，有效期 7 天。
        thumbnail_url:
          type: string
          description: 缩略图 URL。仅当状态为 `SUCCEEDED` 时返回。
        error_message:
          type: string
          description: 可读的错误描述。仅当状态为 `FAILED` 时返回。
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````