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_KEY1. 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).