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

# Aufgabenergebnis abfragen

Die „API zum Abfragen von Aufgabenergebnissen“ wird verwendet, um die von asynchronen Aufgaben zurückgegebenen Bild-, Audio- oder Videoergebnisse abzurufen.

## Anfrageheader

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

<ParamField header="Authorization" type="string" required={true}>
  Bearer-Authentifizierungsformat: Bearer \{\{API Key}}.
</ParamField>

## Abfrageparameter

<ParamField query="task_id" type="string" required={true}>
  Der in der 200-Antwort der asynchronen API zurückgegebene Wert task\_id.
</ParamField>

## Antwortparameter

<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-Informationen

      <Expandable title="properties" defaultOpen={false}>
        <ResponseField name="request_info" type="string" required={false}>
          Zeichnet die Anfrageparameter zu Debugging-Zwecken auf.
        </ResponseField>

        <ResponseField name="submit_time_ms" type="string" required={false}>
          Zeitstempel der Aufgabenübermittlung (in Millisekunden).
        </ResponseField>

        <ResponseField name="execute_time_ms" type="string" required={false}>
          Zeitstempel, zu dem die Ausführung der Aufgabe beginnt (in Millisekunden).
        </ResponseField>

        <ResponseField name="complete_time_ms" type="string" required={false}>
          Zeitstempel, zu dem die Aufgabe abgeschlossen wird (in Millisekunden).
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

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

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

    <ResponseField name="status" type="string" required={true}>
      Aktueller Status der Aufgabe. Enumerationswerte:

      * `TASK_STATUS_QUEUED`: Aufgabe befindet sich in der Warteschlange und wartet auf Verarbeitung;
      * `TASK_STATUS_SUCCEED`: Aufgabe wurde erfolgreich abgeschlossen;
      * `TASK_STATUS_FAILED`: Aufgabe ist fehlgeschlagen;
      * `TASK_STATUS_PROCESSING`: Aufgabe wird gerade verarbeitet;
    </ResponseField>

    <ResponseField name="reason" type="string" required={false}>
      Grund für das Fehlschlagen der Aufgabe; dieses Feld ist gültig, wenn die Aufgabe fehlschlägt.
    </ResponseField>

    <ResponseField name="task_type" type="string" required={true}>
      Typ der Aufgabe.
    </ResponseField>

    <ResponseField name="eta" type="number" required={false}>
      Geschätzte Zeit bis zum Abschluss der Aufgabe, in Sekunden. Dieses Feld ist nur bei einigen APIs gültig.
    </ResponseField>

    <ResponseField name="progress_percent" type="number" required={false}>
      Fortschritt der Aufgabenerledigung in Prozent. Diese Funktion ist derzeit nur verfügbar für:<br /> 1. Videoerzeugungs-API; <br /> 2. Text-zu-Bild-API und Bild-zu-Bild-API.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="images" type="object[]" required={false}>
  Gibt die ausgegebenen Bilder für bildbezogene Aufgaben zurück.

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

    <ResponseField name="image_url_ttl" type="integer" required={false}>
      Ablaufzeit der Bild-URL (in Sekunden). Der Standardwert beträgt 3600 Sekunden.
    </ResponseField>

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

<ResponseField name="videos" type="object[]" required={false}>
  Gibt die ausgegebenen Videos für videobezogene Aufgaben zurück.

  <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}>
      Ablaufzeit der Video-URL (in Sekunden). Der Standardwert beträgt 3600 Sekunden.
    </ResponseField>

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

<ResponseField name="audios" type="object[]" required={false}>
  Gibt die ausgegebenen Audiodateien für audiobezogene Aufgaben zurück.

  <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}>
      Ablaufzeit der Audio-URL (in Sekunden). Der Standardwert beträgt 3600 Sekunden.
    </ResponseField>

    <ResponseField name="audio_type" type="string" required={false}>
      Audiotyp. Enumerationswert: `wav`
    </ResponseField>

    <ResponseField name="audio_metadata" type="object" required={false}>
      Detaillierte Metadateninformationen der generierten Audiodatei.

      <Expandable title="properties" defaultOpen={false}>
        <ResponseField name="text" type="string" required={false}>
          Im Audio enthaltener Text.
        </ResponseField>

        <ResponseField name="start_time" type="number" required={false}>
          Startzeit des Textes (in Sekunden).
        </ResponseField>

        <ResponseField name="end_time" type="number" required={false}>
          Endzeit des Textes (in Sekunden).
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>