C Clippah← Back to site
Clippah Media

API docs

Limited beta · 25 September 2026

Generate clips from a rights-cleared MP4 file and timed transcript. The hosted API and MCP are live in limited beta; self-serve API packs can be purchased through the Clippah MCP.

What it does

Supply an MP4 you own or are licensed to edit, a timed WebVTT transcript (used to choose cuts and burned into the output clips), the number of clips (1–4), the format (vertical short or two-minute landscape), and a caption style. Create a job, check its status, then download each finished clip. Source availability and processing can delay a job. A returned clip should be reviewed before publishing.

Access and rights

Private clip jobs require a paid account key or authorized account link. To purchase self-serve API clips, add https://api.clippahmedia.com/mcp in a compatible client, call list_packs, then create_pack_checkout for a pack you select. This creates a new hosted Stripe checkout URL without charging you. After payment, the buyer return leads to https://api.clippahmedia.com/redeem, where the one-time claim reveals the API key once. The website’s done-for-you clip pack Payment Links do not issue API keys. See the connection guide. Keep the key secret; do not put it on web pages or share it. A rights declaration is required on every job; Clippah may ask for further proof. A YouTube URL by itself is not accepted as permission to download video. We do not accept arbitrary YouTube URL downloads in the production-ready design.

Current development contract

POST /v1/jobs accepts JSON fields file_base64 (MP4, up to 25MB decoded), captions_vtt, rights_confirmed: true, format: short|two_minute, count: 1–4, and caption_style: minimal|bold. It returns HTTP 202 with a job ID and status path. GET /v1/jobs/{id} returns status and, when complete, short-lived signed download paths. GET /v1/jobs/{id}/clips/{index} requires the same account key and valid signature. Unauthorized access returns 401 or 404; invalid input 400; quota 429.

This development transport encodes video in JSON and will be replaced with a streaming upload path before public launch. The live OpenAPI spec is at https://api.clippahmedia.com/openapi.json.

Limits

No guaranteed turnaround, views or platform approval. The beta currently allows one active job and five jobs per account per day. The MCP lists currently available API packs and their base prices; hosted checkout shows the final price and any tax before payment.

Policies and support

See the privacy policy, self-serve API terms and copyright and takedown process. Questions: [email protected].