> ## 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.

# Consultar resultado de tarea

La «API de consulta de resultado de tarea» se utiliza para obtener los resultados de imagen, audio o video devueltos por tareas asíncronas.

## Encabezados de solicitud

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

<ParamField header="Authorization" type="string" required={true}>
  Formato de autenticación Bearer: Bearer \{\{API Key}}.
</ParamField>

## Parámetros de consulta

<ParamField query="task_id" type="string" required={true}>
  El valor task\_id devuelto en la respuesta 200 de la API asíncrona.
</ParamField>

## Parámetros de información de respuesta

<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}>
      Información de depuración

      <Expandable title="properties" defaultOpen={false}>
        <ResponseField name="request_info" type="string" required={false}>
          Registra los parámetros de solicitud para la depuración.
        </ResponseField>

        <ResponseField name="submit_time_ms" type="string" required={false}>
          Marca de tiempo cuando se envió la tarea (en milisegundos).
        </ResponseField>

        <ResponseField name="execute_time_ms" type="string" required={false}>
          Marca de tiempo cuando la tarea comenzó a ejecutarse (en milisegundos).
        </ResponseField>

        <ResponseField name="complete_time_ms" type="string" required={false}>
          Marca de tiempo cuando se completó la tarea (en milisegundos).
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="task" type="object" required={true}>
  Información detallada de la tarea.

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

    <ResponseField name="status" type="string" required={true}>
      Estado actual de la tarea. Valores enumerados:

      * `TASK_STATUS_QUEUED`: la tarea está en cola, esperando ser procesada;
      * `TASK_STATUS_SUCCEED`: la tarea se completó correctamente;
      * `TASK_STATUS_FAILED`: la tarea falló;
      * `TASK_STATUS_PROCESSING`: la tarea se está procesando;
    </ResponseField>

    <ResponseField name="reason" type="string" required={false}>
      Motivo del fallo de la tarea; este campo es válido cuando la tarea falla.
    </ResponseField>

    <ResponseField name="task_type" type="string" required={true}>
      Tipo de la tarea.
    </ResponseField>

    <ResponseField name="eta" type="number" required={false}>
      Tiempo estimado para completar la tarea, en segundos. Este campo solo es válido para algunas API.
    </ResponseField>

    <ResponseField name="progress_percent" type="number" required={false}>
      Porcentaje de progreso de finalización de la tarea. Actualmente, esta función solo está disponible para:<br /> 1. API de generación de video; <br /> 2. API de texto a imagen y API de imagen a imagen.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="images" type="object[]" required={false}>
  Devuelve los resultados de imágenes de salida de las tareas de tipo imagen.

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

    <ResponseField name="image_url_ttl" type="integer" required={false}>
      Tiempo de expiración de la URL de la imagen (en segundos). El valor predeterminado es 3600 segundos.
    </ResponseField>

    <ResponseField name="image_type" type="string" required={false}>
      Tipo de imagen. Valores enumerados: `jpeg, png, webp`
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="videos" type="object[]" required={false}>
  Devuelve los resultados de videos de salida de las tareas de tipo video.

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

    <ResponseField name="video_url_ttl" type="string" required={false}>
      Tiempo de expiración de la URL del video (en segundos). El valor predeterminado es 3600 segundos.
    </ResponseField>

    <ResponseField name="video_type" type="string" required={false}>
      Tipo de video. Valores enumerados: `mp4, gif`
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="audios" type="object[]" required={false}>
  Devuelve los resultados de audio de salida de las tareas de tipo audio.

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

    <ResponseField name="audio_url_ttl" type="string" required={false}>
      Tiempo de expiración de la URL del audio (en segundos). El valor predeterminado es 3600 segundos.
    </ResponseField>

    <ResponseField name="audio_type" type="string" required={false}>
      Tipo de audio. Valores enumerados: `wav`
    </ResponseField>

    <ResponseField name="audio_metadata" type="object" required={false}>
      Información detallada de metadatos del archivo de audio generado.

      <Expandable title="properties" defaultOpen={false}>
        <ResponseField name="text" type="string" required={false}>
          Información de texto contenida en el audio.
        </ResponseField>

        <ResponseField name="start_time" type="number" required={false}>
          Hora de inicio del texto (en segundos).
        </ResponseField>

        <ResponseField name="end_time" type="number" required={false}>
          Hora de finalización del texto (en segundos).
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>