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

> ## Agent Instructions
> Send API requests to https://api.ttapi.io with the TT-API-KEY header. Midjourney account hosting uses https://hold.ttapi.io. Claude Code uses https://cc.ttapi.io.
> Most generation endpoints are asynchronous. The submit response returns a job id. Poll that product's fetch endpoint, or pass a webhook on the submit request. A fetch call does not start a new generation.
> 1 USD = 100 quota. Check the pricing page for that product before estimating cost.
> This file lists the English docs. Follow every /_llms/ link recursively for the API reference, Chinese, and Russian. Open a page's .md URL for the endpoint schema.

# Fetch Result

> Query image generation task results

This is the **Seedream Image Generation API** fetch endpoint. Query image generation task status and results via `id`.


## OpenAPI

````yaml openapi/en/seedream.json GET /sd/api/v3/images/generations/tasks/{id}
openapi: 3.1.0
info:
  title: Seedream Image Generation API
  version: 1.0.0
  description: Seedream Image Generation API - Submit tasks and query results.
servers:
  - url: https://api.ttapi.io
security: []
paths:
  /sd/api/v3/images/generations/tasks/{id}:
    get:
      description: Query image generation task results
      parameters:
        - name: id
          in: path
          required: true
          description: Task ID
          schema:
            type: string
      responses:
        '200':
          description: Request successful
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - PENDING_QUEUE
                      - ON_QUEUE
                      - SUCCESS
                      - FAILED
                    description: Task status
                  message:
                    type: string
                    description: Response message
                  id:
                    type: string
                    description: Task ID
                  data:
                    type: object
                    description: Task result
                    properties:
                      images:
                        type: array
                        description: List of generated image URLs
                        items:
                          type: string
                      size:
                        type: string
                        description: Image width/height pixel values
                      output_format:
                        type: string
                        description: Output format
                      quota:
                        type: string
                        description: Quota consumed
                example:
                  status: SUCCESS
                  message: success
                  id: 30d9b07d-7349-4cbc-8e11-9ba302c6d165
                  data:
                    images:
                      - https://cdn.ttapi.io/seedream/2026-10-21/xxxx.png
                    size: 2048x2048
                    output_format: jpeg
                    quota: '0'
                required:
                  - status
                  - message
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
      security:
        - CustomApiKey: []
components:
  responses:
    400Response:
      description: Parameter error
      content:
        application/json:
          schema:
            type: object
            properties:
              status:
                type: string
                example: FAILED
              message:
                type: string
                example: '"prompt" cannot be empty.'
              data:
                type: object
            required:
              - status
              - message
    401Response:
      description: Authorization failed
      content:
        application/json:
          schema:
            type: object
            properties:
              status:
                type: string
                example: FAILED
              message:
                type: string
                example: Wrong TT-API-KEY or email is not activated.
            required:
              - status
              - message
  securitySchemes:
    CustomApiKey:
      type: apiKey
      in: header
      name: TT-API-KEY
      description: >-
        Get your API key from the <a href='https://dashboard.ttapi.io'
        target='_blank'>TTAPI Dashboard</a>.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.