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

# タスク結果の照会

「タスク結果照会 API」は、非同期タスクが返す画像、音声、または動画の結果を取得するために使用します。

## リクエストヘッダー

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

<ParamField header="Authorization" type="string" required={true}>
  Bearer 認証形式: Bearer \{\{API Key}}。
</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>
