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

# View the image generation task

> Retrieve the current status and result of a single image generation sub-task by its task ID.



## OpenAPI

````yaml GET /v1/image_generate/{task_id}
openapi: 3.1.1
info:
  title: OpenAPI Plant Store
  description: >-
    A sample API that uses a plant store as an example to demonstrate features
    in the OpenAPI specification
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.keevx.com/
security:
  - bearerAuth: []
paths:
  /v1/image_generate/{task_id}:
    get:
      summary: Query image generation task status
      description: >-
        Retrieve the current status and result of a single image generation
        sub-task by its task ID.
      operationId: getImageGenerateStatus
      parameters:
        - name: task_id
          in: path
          required: true
          schema:
            type: string
          description: >-
            The sub-image task ID returned by the submit endpoint (one element
            from the `task_ids` array).
      responses:
        '200':
          description: Query result returned.
          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: In progress
                  value:
                    code: 0
                    msg: ok
                    data:
                      task_id: i2is-a1b2c3d4e5f6
                      status: GENERATING
                      image_url: ''
                      thumbnail_url: ''
                      error_message: ''
                succeeded:
                  summary: Generation succeeded
                  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: Generation failed
                  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: Task not found (code 110002)
                  value:
                    code: 110002
                    msg: image not found
components:
  schemas:
    BaseResponse:
      type: object
      required:
        - code
        - msg
      properties:
        code:
          type: integer
          description: >-
            Business status code. `0` indicates success; non-zero indicates an
            error.
        msg:
          type: string
          description: Status message. `ok` on success; error description on failure.
        data:
          description: Business data payload. Omitted or null on error responses.
    ImageGenerateInfo:
      type: object
      required:
        - task_id
        - status
      properties:
        task_id:
          type: string
          description: Sub-image task ID.
        status:
          type: string
          enum:
            - GENERATING
            - SUCCEEDED
            - FAILED
          description: Current task status.
        image_url:
          type: string
          description: >-
            URL of the generated image. Populated only when status is
            `SUCCEEDED`. Valid for 7 days.
        thumbnail_url:
          type: string
          description: >-
            URL of the thumbnail image. Populated only when status is
            `SUCCEEDED`.
        error_message:
          type: string
          description: >-
            Human-readable error description. Populated only when status is
            `FAILED`.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````