単一ビデオ ステータス

この API ガイドでは、単一のビデオ リクエストのステータスを追跡する方法の概要を説明します。

---

この API を使用すると、ユーザーは video ID を指定してビデオ リクエストのステータスを確認できます。 応答には次のものが含まれます。

• status: ビデオ リクエストの現在の状態 (Pending、Completed、または Failed) を示します。Pending の場合、ビデオはまだ生成中で、すぐに準備が整います。Completed の場合、ビデオは正常に生成されました。Failed の場合、ビデオの生成に失敗しました。
• video_url: Completed の場合、ビデオにアクセスするための URL が含まれます。Pending の場合、ビデオが進行中であることを示します。Failed の場合、ビデオの生成が失敗したことを示します。

リクエスト応答(保留中)

curl --request GET \
     --url 'https://api.immersive-fox.com/v1/video_requests/status/<video_id>' \
     --header 'X-Api-Key: <your-api-key>' \
     --header 'Content-Type: application/json' \

{
    "status": "Pending",
    "video_url": "Video generation in progress, will be ready soon!"
}

=== 「回答(完了)」

```javascript
{
    "status": "Completed",
    "video_url": "https://api.immersive-fox.com/v/<video_hash>"
}
```

応答(失敗)

{
    "status": "Failed",
    "video_url": "Video generation failed, no video url is available!"
}