✦ Developer API

The video clipping API

Turn long videos into captioned vertical clips programmatically. Transparent per-minute pricing — no credits, no hidden sales call.

clip.video exposes a simple HTTP API for clipping, transcription, captioning, and the utility conversions. Embed it in your own product, automate a content pipeline, or clip at scale. The full API (with API-key auth + a published per-minute rate) is available on the Studio plan; the endpoints below power the app today.

Authentication

Studio keys authenticate with a bearer header. Keep your key server-side.

Authorization: Bearer sk_live_your_api_key

1 · Create a clip job

Upload a file or pass a video URL. mode selects the operation: clip (ranked shorts), captions (caption the whole video), or transcribe (transcript only).

# by URL
curl -X POST https://clip.video/api/upload/ \
  -F "url=https://example.com/podcast.mp4" \
  -F "mode=clip" \
  -F "style=hormozi" \
  -F "reframe=auto"

# by file
curl -X POST https://clip.video/api/upload/ \
  -F "file=@episode.mp4" -F "mode=clip"

Response:

{ "error": false, "job_id": "c45de43d67d4...", "redirect": "/v/c45de43d67d4.../" }

2 · Poll job status

The pipeline is asynchronous. Poll until done is true; completed clips arrive in the clips array with a downloadable output URL.

curl https://clip.video/api/status/<job_id>/
{
  "status": "completed",
  "done": true,
  "clip_count": 5,
  "clips": [
    { "uuid": "22a9d58d...", "title": "The Secret to Going Viral",
      "score": 85, "duration": 32.4,
      "output": "/uploads/clips/.../22a9d58d....mp4",
      "thumbnail": "/uploads/clips/.../22a9d58d....jpg" }
  ]
}

3 · Run a utility tool (sync)

The ffmpeg tools return a download link directly. Pass the tool slug (video-to-audio, compress-video, video-to-gif, trim-video, make-video-vertical, …).

curl -X POST https://clip.video/api/tool/ \
  -F "file=@clip.mp4" -F "slug=video-to-audio"
# -> { "error": false, "download": "/uploads/tools/out/....mp3", "name": "audio.mp3" }

4 · Export a transcript

For a transcribe job, export the transcript as txt, srt, or vtt.

curl https://clip.video/v/<job_id>/export/srt/ -o captions.srt

Pricing

Unlike credit-metered APIs, clip.video publishes a flat per-minute wholesale rate on the Studio plan — bill your own users however you like. See pricing or contact us for volume rates and white-label.