curl -X POST https://api.fastdrop.io/api/v1/classify \
-H "Content-Type: application/json" \
-H "X-API-Key: fd_live_your_key_here" \
-d '{
"video_url": "https://example.com/video.mp4",
"capabilities": ["classify", "thumbnails", "diagnostics"],
"processing_tier": "basic"
}'
{
"job_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
"status": "queued",
"credits_charged": 4,
"estimated_seconds": 60,
"poll_url": "/api/v1/classify/a1b2c3d4-5678-90ab-cdef-1234567890ab",
"created_at": "2026-03-05T12:00:00Z"
}
{
"error": {
"code": "invalid_capabilities",
"message": "Unknown capabilities: ['invalid']",
"details": {
"valid_capabilities": ["classify", "thumbnails", "diagnostics", "duplicates", "clips", "transcribe", "full_pipeline"]
}
}
}
{
"error": {
"code": "insufficient_credits",
"message": "Not enough credits for this request",
"details": {
"credits_required": 4,
"credits_available": 2
}
}
}
Classification
Classify Video
Submit a video for async classification
POST
/
classify
curl -X POST https://api.fastdrop.io/api/v1/classify \
-H "Content-Type: application/json" \
-H "X-API-Key: fd_live_your_key_here" \
-d '{
"video_url": "https://example.com/video.mp4",
"capabilities": ["classify", "thumbnails", "diagnostics"],
"processing_tier": "basic"
}'
{
"job_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
"status": "queued",
"credits_charged": 4,
"estimated_seconds": 60,
"poll_url": "/api/v1/classify/a1b2c3d4-5678-90ab-cdef-1234567890ab",
"created_at": "2026-03-05T12:00:00Z"
}
{
"error": {
"code": "invalid_capabilities",
"message": "Unknown capabilities: ['invalid']",
"details": {
"valid_capabilities": ["classify", "thumbnails", "diagnostics", "duplicates", "clips", "transcribe", "full_pipeline"]
}
}
}
{
"error": {
"code": "insufficient_credits",
"message": "Not enough credits for this request",
"details": {
"credits_required": 4,
"credits_available": 2
}
}
}
Submit a public video URL for classification. Returns a
job_id immediately — register a webhook to have the result pushed to you, or fetch it with Get Job Status using ?wait=N. See Getting your results.
Public HTTP/HTTPS URL of the video to process. Must be directly downloadable (not a webpage).
Capabilities to run. Options:
classify, thumbnails, diagnostics, duplicates, clips, transcribe, full_pipeline.Processing quality tier:
basic— Heuristic analysis, fastest (2 credits for classify)enhanced— Heuristic + AI fallback (4 credits for classify)premium— Full AI analysis via GPT-4 Vision (6 credits for classify)
Optional. The video’s duration, if you already know it. Lets the request be
rejected before credits are charged when the video is over the limit.FastDrop measures the duration itself once the file is downloaded, so leaving
this out never gets a longer video processed — it just means an over-length
video is charged and then refunded rather than declined up front.
Videos are limited to 60 minutes. Over that, the request fails and any
credits charged are returned automatically. Send
duration_seconds to be
declined immediately instead.Response (202 Accepted)
curl -X POST https://api.fastdrop.io/api/v1/classify \
-H "Content-Type: application/json" \
-H "X-API-Key: fd_live_your_key_here" \
-d '{
"video_url": "https://example.com/video.mp4",
"capabilities": ["classify", "thumbnails", "diagnostics"],
"processing_tier": "basic"
}'
{
"job_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
"status": "queued",
"credits_charged": 4,
"estimated_seconds": 60,
"poll_url": "/api/v1/classify/a1b2c3d4-5678-90ab-cdef-1234567890ab",
"created_at": "2026-03-05T12:00:00Z"
}
{
"error": {
"code": "invalid_capabilities",
"message": "Unknown capabilities: ['invalid']",
"details": {
"valid_capabilities": ["classify", "thumbnails", "diagnostics", "duplicates", "clips", "transcribe", "full_pipeline"]
}
}
}
{
"error": {
"code": "insufficient_credits",
"message": "Not enough credits for this request",
"details": {
"credits_required": 4,
"credits_available": 2
}
}
}