视频状态
本 API 指南概述了检查批量请求状态的过程。
批量请求可能需要一些时间来处理,具体取决于 CSV 文件中的联系人数量。 发起请求后,你需要检查其状态以监控进度,进度将以百分比形式提供。 🦊
快速入门
让我们深入了解如何检查批量请求的进度。 ## 获取批量状态 要检查批量请求的进度,请提供从请求生成或通过批量列表 API获得的'id'作为'video_id'。 作为响应,你将收到:
- 'progress':请求的当前进度百分比。
- 'status':请求的总体状态。
- 'video_links_csv':包含用于下载视频的 URL。
你可以多次调用此端点。 这也会返回 csv 中的部分结果。当视频生成正在进行时,它将返回状态"进行中",进度将低于 100。如果所有视频都生成,则状态将为"完成",进度将为 100。
curl --request GET \
--url 'https://api.immersive-fox.com/v1/bulk_requests/video/<video_id>' \
--header 'X-Api-Key: <your-api-key>' \
--header 'Content-Type: application/json'
{
"id": 494,
"csv_file_name": "my_contacts.csv",
"progress": 55,
"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_contacts.csv",
"progress": 100,
"status": "Completed",
"video_links_csv": "https://my-bucket-name.s3.eu-central-1.amazonaws.com/my_contact_videos.csv"
}