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.
string
required
Public HTTP/HTTPS URL of the video to process. Must be directly downloadable (not a webpage).
string[]
default:"[\"classify\", \"thumbnails\", \"diagnostics\"]"
Capabilities to run. Options:
classify, thumbnails, diagnostics, duplicates, clips, transcribe, full_pipeline.string
default:"basic"
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)
string
Optional URL to receive a POST when processing completes. Must be HTTPS.
number
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)
string
UUID of the created job. Use this to fetch the result.
string
Always
"queued" on submission.integer
Number of credits deducted for this request.
integer
Rough processing time estimate (60-180 seconds).
string
Relative URL for polling:
/api/v1/classify/{job_id}.string
ISO 8601 timestamp.
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
}
}
}