curl -X POST https://api.fastdrop.io/api/v1/batch \
-H "Content-Type: application/json" \
-H "X-API-Key: fd_live_your_key_here" \
-d '{
"videos": [
{"video_url": "https://example.com/video1.mp4"},
{"video_url": "https://example.com/video2.mp4"},
{"video_url": "https://example.com/video3.mp4"}
],
"processing_tier": "basic"
}'
{
"batch_id": "batch_xyz789",
"status": "processing",
"total_videos": 3,
"total_credits": 12,
"jobs": [
{
"job_id": "a1b2c3d4-...",
"video_url": "https://example.com/video1.mp4",
"status": "queued",
"credits_charged": 4
},
{
"job_id": "e5f6g7h8-...",
"video_url": "https://example.com/video2.mp4",
"status": "queued",
"credits_charged": 4
},
{
"job_id": "i9j0k1l2-...",
"video_url": "https://example.com/video3.mp4",
"status": "queued",
"credits_charged": 4
}
],
"poll_url": "/api/v1/batch/batch_xyz789",
"created_at": "2026-03-05T12:00:00Z"
}
{
"error": {
"code": "batch_too_large",
"message": "Batch exceeds maximum of 50 videos"
}
}
Batch Processing
Create Batch
Submit up to 50 videos for batch classification
POST
/
batch
curl -X POST https://api.fastdrop.io/api/v1/batch \
-H "Content-Type: application/json" \
-H "X-API-Key: fd_live_your_key_here" \
-d '{
"videos": [
{"video_url": "https://example.com/video1.mp4"},
{"video_url": "https://example.com/video2.mp4"},
{"video_url": "https://example.com/video3.mp4"}
],
"processing_tier": "basic"
}'
{
"batch_id": "batch_xyz789",
"status": "processing",
"total_videos": 3,
"total_credits": 12,
"jobs": [
{
"job_id": "a1b2c3d4-...",
"video_url": "https://example.com/video1.mp4",
"status": "queued",
"credits_charged": 4
},
{
"job_id": "e5f6g7h8-...",
"video_url": "https://example.com/video2.mp4",
"status": "queued",
"credits_charged": 4
},
{
"job_id": "i9j0k1l2-...",
"video_url": "https://example.com/video3.mp4",
"status": "queued",
"credits_charged": 4
}
],
"poll_url": "/api/v1/batch/batch_xyz789",
"created_at": "2026-03-05T12:00:00Z"
}
{
"error": {
"code": "batch_too_large",
"message": "Batch exceeds maximum of 50 videos"
}
}
Submit multiple videos for classification in a single request. Credits are pre-authorized upfront for all videos and refunded per-video on failure.
object[]
required
string
default:"basic"
Processing tier applied to all videos:
basic, enhanced, or premium.Response (202 Accepted)
string
Unique batch identifier for polling.
string
Always
"processing" on submission.integer
Number of videos in the batch.
integer
Total credits pre-authorized for all videos.
object[]
Per-video job summaries with
job_id, video_url, status, and credits_charged.string
URL for polling batch status.
curl -X POST https://api.fastdrop.io/api/v1/batch \
-H "Content-Type: application/json" \
-H "X-API-Key: fd_live_your_key_here" \
-d '{
"videos": [
{"video_url": "https://example.com/video1.mp4"},
{"video_url": "https://example.com/video2.mp4"},
{"video_url": "https://example.com/video3.mp4"}
],
"processing_tier": "basic"
}'
{
"batch_id": "batch_xyz789",
"status": "processing",
"total_videos": 3,
"total_credits": 12,
"jobs": [
{
"job_id": "a1b2c3d4-...",
"video_url": "https://example.com/video1.mp4",
"status": "queued",
"credits_charged": 4
},
{
"job_id": "e5f6g7h8-...",
"video_url": "https://example.com/video2.mp4",
"status": "queued",
"credits_charged": 4
},
{
"job_id": "i9j0k1l2-...",
"video_url": "https://example.com/video3.mp4",
"status": "queued",
"credits_charged": 4
}
],
"poll_url": "/api/v1/batch/batch_xyz789",
"created_at": "2026-03-05T12:00:00Z"
}
{
"error": {
"code": "batch_too_large",
"message": "Batch exceeds maximum of 50 videos"
}
}