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

# 查询任务结果

「查询任务结果 API」用来获取异步任务返回的图像、音频或视频结果。

## 请求头

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

<ParamField header="Authorization" type="string" required={true}>
  Bearer 身份验证格式，例如：Bearer \{\{API 密钥}}。
</ParamField>

## 查询参数

<ParamField query="task_id" type="string" required={true}>
  在异步 API 的 200 响应中返回的 task\_id 值。
</ParamField>

## 响应参数

<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}>
      调试信息

      <Expandable title="properties" defaultOpen={false}>
        <ResponseField name="request_info" type="string" required={false}>
          记录请求参数以用于调试。
        </ResponseField>

        <ResponseField name="submit_time_ms" type="string" required={false}>
          任务提交时的时间戳（以毫秒为单位）。
        </ResponseField>

        <ResponseField name="execute_time_ms" type="string" required={false}>
          任务开始执行时的时间戳（以毫秒为单位）。
        </ResponseField>

        <ResponseField name="complete_time_ms" type="string" required={false}>
          任务完成时的时间戳（以毫秒为单位）。
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="task" type="object" required={true}>
  任务详细信息。

  <Expandable title="properties" defaultOpen={true}>
    <ResponseField name="task_id" type="string" required={true}>
      任务 ID。
    </ResponseField>

    <ResponseField name="status" type="string" required={true}>
      任务当前状态。枚举值:

      * `TASK_STATUS_QUEUED`：任务排队中，等待处理；
      * `TASK_STATUS_SUCCEED`：任务已成功；
      * `TASK_STATUS_FAILED`：任务失败；
      * `TASK_STATUS_PROCESSING`：任务正在处理中；
    </ResponseField>

    <ResponseField name="reason" type="string" required={false}>
      任务失败原因，当任务失败时，该字段有效。
    </ResponseField>

    <ResponseField name="task_type" type="string" required={true}>
      任务的类型。
    </ResponseField>

    <ResponseField name="eta" type="number" required={false}>
      任务预计完成时间，以秒为单位。只有部分 API 该字段有效。
    </ResponseField>

    <ResponseField name="progress_percent" type="number" required={false}>
      任务完成的进度百分比。此功能目前仅适用于：<br /> 1. 视频生成 API; <br /> 2. 文本到图像 API 和 图像到图像 API。
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="images" type="object[]" required={false}>
  返回与图像类任务的输出图片结果。

  <Expandable title="properties" defaultOpen={false}>
    <ResponseField name="image_url" type="string" required={false}>
      图像 URL。
    </ResponseField>

    <ResponseField name="image_url_ttl" type="integer" required={false}>
      图像 URL 过期时间（以秒为单位）。默认值为 3600 秒。
    </ResponseField>

    <ResponseField name="image_type" type="string" required={false}>
      图像类型。枚举值: `jpeg, png, webp`
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="videos" type="object[]" required={false}>
  返回与视频类任务的输出视频结果。

  <Expandable title="properties" defaultOpen={false}>
    <ResponseField name="video_url" type="string" required={false}>
      视频 URL。
    </ResponseField>

    <ResponseField name="video_url_ttl" type="string" required={false}>
      视频 URL 过期时间（以秒为单位）。默认值为 3600 秒。
    </ResponseField>

    <ResponseField name="video_type" type="string" required={false}>
      视频类型。枚举值: `mp4, gif`
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="audios" type="object[]" required={false}>
  返回与音频类任务的输出音频结果。

  <Expandable title="properties" defaultOpen={false}>
    <ResponseField name="audio_url" type="string" required={false}>
      音频 URL。
    </ResponseField>

    <ResponseField name="audio_url_ttl" type="string" required={false}>
      音频 URL 过期时间（以秒为单位）。默认值为 3600 秒。
    </ResponseField>

    <ResponseField name="audio_type" type="string" required={false}>
      音频类型。枚举值: `wav`
    </ResponseField>

    <ResponseField name="audio_metadata" type="object" required={false}>
      生成的音频文件的详细元数据信息。

      <Expandable title="properties" defaultOpen={false}>
        <ResponseField name="text" type="string" required={false}>
          音频包含的文本信息。
        </ResponseField>

        <ResponseField name="start_time" type="number" required={false}>
          文本的开始时间（以秒为单位）。
        </ResponseField>

        <ResponseField name="end_time" type="number" required={false}>
          文本的结束时间（以秒为单位）。
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>