⚡ Pro: 150 h of stream per month and your streams clipped live, $19/month Upgrade to Pro →

Developer API

Create clips from your own tools (Zapier, Make, n8n, your code): send a video link, KovaClip picks the best moments, reframes to vertical, adds captions and edits. The API is included in the Studio plan and uses the same credits as the website.

Authentication

Create a key on the API page (top menu), then send it in the Authorization header. Keep it secret: it gives access to your projects. You can revoke it at any time.

Authorization: Bearer kova_YOUR_KEY

1. Create a project from a link

Twitch, Kick, TikTok, direct links… (YouTube: no download, upload the file) Every option is optional. category: auto, funny, serious, motivation, story, debate. length: auto, short, medium, long, xlong. framing: auto, fit (full frame), track (vertical). text_mode: all, captions, none.

curl -X POST https://api.kovaclip.com/api/projects \
  -H "Authorization: Bearer kova_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=…",
    "rights_confirmed": true,
    "options": { "category": "funny", "clip_count": 5, "length": "short", "framing": "auto" }
  }'

2. Track progress

status goes through downloading, transcribing, selecting, rendering, then ready (or failed, with error). Poll every 15 to 30 seconds; progress goes from 0 to 100.

curl https://api.kovaclip.com/api/projects/PROJECT_ID \
  -H "Authorization: Bearer kova_YOUR_KEY"

3. Download the clips

Once status is ready, each item of clips has title, duration, score and download_url (a signed link valid for a few hours, to prefix with the API address).

curl -L -o clip.mp4 "https://api.kovaclip.comDOWNLOAD_URL"

Errors

401: invalid or revoked key. 402: out of credits. 403: feature not included in your plan. 400: invalid parameter (the message explains why).