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

# Consulter le résultat d’une tâche

L’API « Consulter le résultat d’une tâche » permet de récupérer les résultats image, audio ou vidéo renvoyés par une tâche asynchrone.

## En-têtes de requête

<ParamField header="Content-Type" type="string" required={true}>
  Valeurs d’énumération : `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Format d’authentification Bearer : Bearer \{\{API Key}}.
</ParamField>

## Paramètres de requête

<ParamField query="task_id" type="string" required={true}>
  La valeur task\_id renvoyée dans la réponse 200 de l’API asynchrone.
</ParamField>

## Paramètres des informations de réponse

<ResponseField name="extra" type="object" required={false}>
  <Expandable title="propriétés" defaultOpen={false}>
    <ResponseField name="seed" type="string" required={false} />

    <ResponseField name="debug_info" type="object" required={false}>
      Informations de débogage

      <Expandable title="propriétés" defaultOpen={false}>
        <ResponseField name="request_info" type="string" required={false}>
          Enregistre les paramètres de requête à des fins de débogage.
        </ResponseField>

        <ResponseField name="submit_time_ms" type="string" required={false}>
          Horodatage au moment de la soumission de la tâche, en millisecondes.
        </ResponseField>

        <ResponseField name="execute_time_ms" type="string" required={false}>
          Horodatage au moment où la tâche commence à s’exécuter, en millisecondes.
        </ResponseField>

        <ResponseField name="complete_time_ms" type="string" required={false}>
          Horodatage au moment où la tâche est terminée, en millisecondes.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="task" type="object" required={true}>
  Informations détaillées de la tâche.

  <Expandable title="propriétés" defaultOpen={true}>
    <ResponseField name="task_id" type="string" required={true}>
      ID de la tâche.
    </ResponseField>

    <ResponseField name="status" type="string" required={true}>
      État actuel de la tâche. Valeurs d’énumération :

      * `TASK_STATUS_QUEUED` : la tâche est en file d’attente, en attente de traitement ;
      * `TASK_STATUS_SUCCEED` : la tâche a réussi ;
      * `TASK_STATUS_FAILED` : la tâche a échoué ;
      * `TASK_STATUS_PROCESSING` : la tâche est en cours de traitement ;
    </ResponseField>

    <ResponseField name="reason" type="string" required={false}>
      Raison de l’échec de la tâche. Ce champ est valide lorsque la tâche échoue.
    </ResponseField>

    <ResponseField name="task_type" type="string" required={true}>
      Type de la tâche.
    </ResponseField>

    <ResponseField name="eta" type="number" required={false}>
      Temps estimé d’achèvement de la tâche, en secondes. Ce champ n’est valide que pour certaines API.
    </ResponseField>

    <ResponseField name="progress_percent" type="number" required={false}>
      Pourcentage de progression de la tâche. Cette fonctionnalité n’est actuellement disponible que pour :<br /> 1. l’API de génération vidéo ; <br /> 2. l’API texte-vers-image et l’API image-vers-image.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="images" type="object[]" required={false}>
  Résultats d’images de sortie renvoyés pour les tâches de type image.

  <Expandable title="propriétés" defaultOpen={false}>
    <ResponseField name="image_url" type="string" required={false}>
      URL de l’image.
    </ResponseField>

    <ResponseField name="image_url_ttl" type="integer" required={false}>
      Délai d’expiration de l’URL de l’image, en secondes. La valeur par défaut est 3600 secondes.
    </ResponseField>

    <ResponseField name="image_type" type="string" required={false}>
      Type d’image. Valeurs d’énumération : `jpeg, png, webp`
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="videos" type="object[]" required={false}>
  Résultats vidéo de sortie renvoyés pour les tâches de type vidéo.

  <Expandable title="propriétés" defaultOpen={false}>
    <ResponseField name="video_url" type="string" required={false}>
      URL de la vidéo.
    </ResponseField>

    <ResponseField name="video_url_ttl" type="string" required={false}>
      Délai d’expiration de l’URL de la vidéo, en secondes. La valeur par défaut est 3600 secondes.
    </ResponseField>

    <ResponseField name="video_type" type="string" required={false}>
      Type de vidéo. Valeurs d’énumération : `mp4, gif`
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="audios" type="object[]" required={false}>
  Résultats audio de sortie renvoyés pour les tâches de type audio.

  <Expandable title="propriétés" defaultOpen={false}>
    <ResponseField name="audio_url" type="string" required={false}>
      URL de l’audio.
    </ResponseField>

    <ResponseField name="audio_url_ttl" type="string" required={false}>
      Délai d’expiration de l’URL de l’audio, en secondes. La valeur par défaut est 3600 secondes.
    </ResponseField>

    <ResponseField name="audio_type" type="string" required={false}>
      Type d’audio. Valeurs d’énumération : `wav`
    </ResponseField>

    <ResponseField name="audio_metadata" type="object" required={false}>
      Informations détaillées de métadonnées du fichier audio généré.

      <Expandable title="propriétés" defaultOpen={false}>
        <ResponseField name="text" type="string" required={false}>
          Informations textuelles contenues dans l’audio.
        </ResponseField>

        <ResponseField name="start_time" type="number" required={false}>
          Heure de début du texte, en secondes.
        </ResponseField>

        <ResponseField name="end_time" type="number" required={false}>
          Heure de fin du texte, en secondes.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>
