コンテンツにスキップ

ビデオ一覧

この API ガイドでは、以前に生成した動画のリストを取得する方法の概要を説明します。


すでに生成されている動画のリストを取得し、作成した動画の合計数を確認するには、この API を使用できます。 このエンドポイントは、以前に生成されたすべての動画の包括的なリストを提供するため、動画の作成を効率的に確認および管理できます。 🦊

クイックスタート

以前に生成したすべての動画の包括的なリストを取得するプロセスを詳しく見ていきましょう。

一括リクエストの一覧表示

この API は、すべてのリクエストの包括的なリストを提供し、応答で以下を受け取ります。

  • 'progress': 各リクエストの現在の進行状況 (パーセンテージ)。
  • 'status': 各リクエストの全体的なステータス。
  • 'video_links_csv': 動画をダウンロードするための URL を含むファイル。

このエンドポイントは複数回呼び出すことができます。これにより、部分的な結果も csv で返されます。ビデオ生成が進行中の場合、ステータスは「進行中」となり、進行状況は 100 未満になります。すべてのビデオが生成されると、ステータスは「完了」となり、進行状況は 100 になります。

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

=== 「応答(進行中)」

```javascript
[
    {
        "id": 494,
        "csv_file_name": "my_contacts.csv",
        "progress": 34,
        "status": "in-progress",
        "video_links_csv": "https://my-bucket-name.s3.eu-central-1.amazonaws.com/my_contact_videos.csv"
    },
    {
        "id": 494,
        "csv_file_name": "my_employees.csv",
        "progress": 80,
        "status": "in-progress",
        "video_links_csv": "https://my-bucket-name.s3.eu-central-1.amazonaws.com/my_employee_videos.csv"
    }

]
```

=== 「回答(完了)」

```javascript
[
    {
        "id": 494,
        "csv_file_name": "my_contacts.csv",
        "progress": 100,
        "status": "Completed",
        "video_links_csv": "https://my-bucket-name.s3.eu-central-1.amazonaws.com/my_contact_videos.csv"
    },
    {
        "id": 494,
        "csv_file_name": "my_employees.csv",
        "progress": 100,
        "status": "Completed",
        "video_links_csv": "https://my-bucket-name.s3.eu-central-1.amazonaws.com/my_employee_videos.csv"
    }

]
```