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

# Query Task Result

The Query Task Result API is used to retrieve image, audio, or video results returned by asynchronous tasks.

## Request Headers

<ParamField header="Content-Type" type="string" required={true}>
  Enum value: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer authentication format: Bearer \{\{API key}}.
</ParamField>

## Query Parameters

<ParamField query="task_id" type="string" required={true}>
  The task\_id value returned in the 200 response from the asynchronous API.
</ParamField>

## Response Parameters

<ResponseField name="extra" type="object" required={false}>
  <Expandable title="properties" defaultOpen={false}>
    <ResponseField name="seed" type="string" required={false} />

    <ResponseField name="debug_info" type="object" required={false}>
      Debug information

      <Expandable title="properties" defaultOpen={false}>
        <ResponseField name="request_info" type="string" required={false}>
          Records the request parameters for debugging.
        </ResponseField>

        <ResponseField name="submit_time_ms" type="string" required={false}>
          The timestamp when the task was submitted, in milliseconds.
        </ResponseField>

        <ResponseField name="execute_time_ms" type="string" required={false}>
          The timestamp when the task started executing, in milliseconds.
        </ResponseField>

        <ResponseField name="complete_time_ms" type="string" required={false}>
          The timestamp when the task was completed, in milliseconds.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="task" type="object" required={true}>
  Task details.

  <Expandable title="properties" defaultOpen={true}>
    <ResponseField name="task_id" type="string" required={true}>
      Task ID.
    </ResponseField>

    <ResponseField name="status" type="string" required={true}>
      The current status of the task. Enum values:

      * `TASK_STATUS_QUEUED`: The task is queued and waiting to be processed;
      * `TASK_STATUS_SUCCEED`: The task succeeded;
      * `TASK_STATUS_FAILED`: The task failed;
      * `TASK_STATUS_PROCESSING`: The task is being processed;
    </ResponseField>

    <ResponseField name="reason" type="string" required={false}>
      The reason the task failed. This field is valid when the task fails.
    </ResponseField>

    <ResponseField name="task_type" type="string" required={true}>
      The type of the task.
    </ResponseField>

    <ResponseField name="eta" type="number" required={false}>
      The estimated time for the task to complete, in seconds. This field is only valid for some APIs.
    </ResponseField>

    <ResponseField name="progress_percent" type="number" required={false}>
      The completion progress percentage of the task. This feature is currently only available for:<br /> 1. Video Generation API; <br /> 2. Text-to-Image API and Image-to-Image API.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="images" type="object[]" required={false}>
  Returns the output image results for image tasks.

  <Expandable title="properties" defaultOpen={false}>
    <ResponseField name="image_url" type="string" required={false}>
      Image URL.
    </ResponseField>

    <ResponseField name="image_url_ttl" type="integer" required={false}>
      Image URL expiration time, in seconds. The default value is 3600 seconds.
    </ResponseField>

    <ResponseField name="image_type" type="string" required={false}>
      Image type. Enum values: `jpeg, png, webp`
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="videos" type="object[]" required={false}>
  Returns the output video results for video tasks.

  <Expandable title="properties" defaultOpen={false}>
    <ResponseField name="video_url" type="string" required={false}>
      Video URL.
    </ResponseField>

    <ResponseField name="video_url_ttl" type="string" required={false}>
      Video URL expiration time, in seconds. The default value is 3600 seconds.
    </ResponseField>

    <ResponseField name="video_type" type="string" required={false}>
      Video type. Enum values: `mp4, gif`
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="audios" type="object[]" required={false}>
  Returns the output audio results for audio tasks.

  <Expandable title="properties" defaultOpen={false}>
    <ResponseField name="audio_url" type="string" required={false}>
      Audio URL.
    </ResponseField>

    <ResponseField name="audio_url_ttl" type="string" required={false}>
      Audio URL expiration time, in seconds. The default value is 3600 seconds.
    </ResponseField>

    <ResponseField name="audio_type" type="string" required={false}>
      Audio type. Enum value: `wav`
    </ResponseField>

    <ResponseField name="audio_metadata" type="object" required={false}>
      Detailed metadata information for the generated audio file.

      <Expandable title="properties" defaultOpen={false}>
        <ResponseField name="text" type="string" required={false}>
          The text information contained in the audio.
        </ResponseField>

        <ResponseField name="start_time" type="number" required={false}>
          The start time of the text, in seconds.
        </ResponseField>

        <ResponseField name="end_time" type="number" required={false}>
          The end time of the text, in seconds.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>
