curl -X POST https://api.fastdrop.io/api/v1/clips \
-H "Content-Type: application/json" \
-H "X-API-Key: fd_live_your_key_here" \
-d '{"video_url": "https://example.com/podcast-episode.mp4"}'
{
"job_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
"status": "queued",
"credits_charged": 2,
"estimated_seconds": 60,
"poll_url": "/api/v1/classify/a1b2c3d4-5678-90ab-cdef-1234567890ab",
"created_at": "2026-03-05T12:00:00Z"
}
Standalone Capabilities
Detect Clips
Detect clip candidate timestamps without classification
POST
/
clips
curl -X POST https://api.fastdrop.io/api/v1/clips \
-H "Content-Type: application/json" \
-H "X-API-Key: fd_live_your_key_here" \
-d '{"video_url": "https://example.com/podcast-episode.mp4"}'
{
"job_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
"status": "queued",
"credits_charged": 2,
"estimated_seconds": 60,
"poll_url": "/api/v1/classify/a1b2c3d4-5678-90ab-cdef-1234567890ab",
"created_at": "2026-03-05T12:00:00Z"
}
Detect clip candidate timestamps with labels, explanations, and confidence scores. Useful for podcast highlights, interview moments, and social media cuts.
Cost: 2 credits
string
required
Public HTTP/HTTPS URL of the video.
string
Optional HTTPS URL to receive a POST when processing completes.
Response (202 Accepted)
Returns a job submission withjob_id. Get the result from Get Job Status with ?wait=N, or subscribe to job.completed via a webhook.
curl -X POST https://api.fastdrop.io/api/v1/clips \
-H "Content-Type: application/json" \
-H "X-API-Key: fd_live_your_key_here" \
-d '{"video_url": "https://example.com/podcast-episode.mp4"}'
{
"job_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
"status": "queued",
"credits_charged": 2,
"estimated_seconds": 60,
"poll_url": "/api/v1/classify/a1b2c3d4-5678-90ab-cdef-1234567890ab",
"created_at": "2026-03-05T12:00:00Z"
}
Result format
When the job completes, theresults field contains:
{
"clips": [
{
"start_time": 5.2,
"end_time": 25.8,
"label": "Key discussion point",
"explanation": "Sustained speech with clear topic boundaries",
"confidence": 0.82
},
{
"start_time": 45.0,
"end_time": 72.3,
"label": "Highlight moment",
"explanation": "High-energy segment with natural pause boundaries",
"confidence": 0.75
}
]
}