⚡ Pro : 150 h de stream par mois et tes lives clippés en direct, 19 $/mois Passer à Pro →

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_KEY

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