API développeur
Créez des clips depuis vos propres outils (Zapier, Make, n8n, votre code) : envoyez un lien de vidéo, KovaClip choisit les meilleurs moments, recadre en vertical, sous-titre et monte. L'API est incluse dans la formule Studio et consomme les mêmes crédits que le site.
Authentification
Créez une clé dans la page API (menu du haut), puis envoyez-la dans l'en-tête Authorization. Gardez-la secrète : elle donne accès à vos projets. Vous pouvez la révoquer à tout moment.
Authorization: Bearer kova_YOUR_KEY1. Créer un projet à partir d'un lien
Twitch, Kick, TikTok, liens directs… (YouTube : pas de téléchargement, envoyez le fichier) Toutes les options sont facultatives. category : auto, funny, serious, motivation, story, debate. length : auto, short, medium, long, xlong. framing : auto, fit (image entière), 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. Suivre l'avancement
status passe par downloading, transcribing, selecting, rendering puis ready (ou failed, avec error). Interrogez toutes les 15 à 30 secondes ; progress va de 0 à 100.
curl https://api.kovaclip.com/api/projects/PROJECT_ID \
-H "Authorization: Bearer kova_YOUR_KEY"3. Télécharger les clips
Quand status vaut ready, chaque clip de clips contient title, duration, score et download_url (lien signé valable quelques heures, à préfixer par l'adresse de l'API).
curl -L -o clip.mp4 "https://api.kovaclip.comDOWNLOAD_URL"Erreurs
401 : clé invalide ou révoquée. 402 : crédits épuisés. 403 : fonction non incluse dans votre formule. 400 : paramètre invalide (le message explique pourquoi).