> ## 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 da tarefa

A「API de consulta de resultado da tarefa」é usada para obter os resultados de imagem, áudio ou vídeo retornados por tarefas assíncronas.

## Cabeçalhos da solicitação

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

<ParamField header="Authorization" type="string" required={true}>
  Formato de autenticação Bearer: Bearer \{\{API Key}}.
</ParamField>

## Parâmetros de consulta

<ParamField query="task_id" type="string" required={true}>
  O valor de task\_id retornado na resposta 200 da API assíncrona.
</ParamField>

## Parâmetros de informações da resposta

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

    <ResponseField name="debug_info" type="object" required={false}>
      Informações de depuração

      <Expandable title="propriedades" defaultOpen={false}>
        <ResponseField name="request_info" type="string" required={false}>
          Registra os parâmetros da solicitação para depuração.
        </ResponseField>

        <ResponseField name="submit_time_ms" type="string" required={false}>
          Timestamp no momento do envio da tarefa (em milissegundos).
        </ResponseField>

        <ResponseField name="execute_time_ms" type="string" required={false}>
          Timestamp no momento em que a tarefa começa a ser executada (em milissegundos).
        </ResponseField>

        <ResponseField name="complete_time_ms" type="string" required={false}>
          Timestamp no momento em que a tarefa é concluída (em milissegundos).
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="task" type="object" required={true}>
  Informações detalhadas da tarefa.

  <Expandable title="propriedades" defaultOpen={true}>
    <ResponseField name="task_id" type="string" required={true}>
      ID da tarefa.
    </ResponseField>

    <ResponseField name="status" type="string" required={true}>
      Status atual da tarefa. Valores enumerados:

      * `TASK_STATUS_QUEUED`: tarefa na fila, aguardando processamento;
      * `TASK_STATUS_SUCCEED`: tarefa concluída com sucesso;
      * `TASK_STATUS_FAILED`: falha na tarefa;
      * `TASK_STATUS_PROCESSING`: tarefa em processamento;
    </ResponseField>

    <ResponseField name="reason" type="string" required={false}>
      Motivo da falha da tarefa; este campo é válido quando a tarefa falha.
    </ResponseField>

    <ResponseField name="task_type" type="string" required={true}>
      Tipo da tarefa.
    </ResponseField>

    <ResponseField name="eta" type="number" required={false}>
      Tempo estimado para conclusão da tarefa, em segundos. Este campo é válido apenas para algumas APIs.
    </ResponseField>

    <ResponseField name="progress_percent" type="number" required={false}>
      Percentual de progresso de conclusão da tarefa. No momento, este recurso se aplica apenas a:<br /> 1. API de geração de vídeo; <br /> 2. API de texto para imagem e API de imagem para imagem.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="images" type="object[]" required={false}>
  Retorna os resultados de imagens de saída para tarefas do tipo imagem.

  <Expandable title="propriedades" defaultOpen={false}>
    <ResponseField name="image_url" type="string" required={false}>
      URL da imagem.
    </ResponseField>

    <ResponseField name="image_url_ttl" type="integer" required={false}>
      Tempo de expiração da URL da imagem (em segundos). O valor padrão é 3600 segundos.
    </ResponseField>

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

<ResponseField name="videos" type="object[]" required={false}>
  Retorna os resultados de vídeos de saída para tarefas do tipo vídeo.

  <Expandable title="propriedades" defaultOpen={false}>
    <ResponseField name="video_url" type="string" required={false}>
      URL do vídeo.
    </ResponseField>

    <ResponseField name="video_url_ttl" type="string" required={false}>
      Tempo de expiração da URL do vídeo (em segundos). O valor padrão é 3600 segundos.
    </ResponseField>

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

<ResponseField name="audios" type="object[]" required={false}>
  Retorna os resultados de áudios de saída para tarefas do tipo áudio.

  <Expandable title="propriedades" defaultOpen={false}>
    <ResponseField name="audio_url" type="string" required={false}>
      URL do áudio.
    </ResponseField>

    <ResponseField name="audio_url_ttl" type="string" required={false}>
      Tempo de expiração da URL do áudio (em segundos). O valor padrão é 3600 segundos.
    </ResponseField>

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

    <ResponseField name="audio_metadata" type="object" required={false}>
      Informações detalhadas de metadados do arquivo de áudio gerado.

      <Expandable title="propriedades" defaultOpen={false}>
        <ResponseField name="text" type="string" required={false}>
          Informações de texto contidas no áudio.
        </ResponseField>

        <ResponseField name="start_time" type="number" required={false}>
          Hora de início do texto (em segundos).
        </ResponseField>

        <ResponseField name="end_time" type="number" required={false}>
          Hora de término do texto (em segundos).
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>