Fonctionnalité

API de découpage vidéo : transforme tes longues vidéos en Shorts avec ton code

Q: StoryCut propose-t-il une API ?

Oui. L’API REST StoryCut lance des traitements AI Clips à partir d’un lien YouTube, répertorie les clips et leurs scores de viralité, puis les exporte en MP4. Des webhooks signés t’indiquent quand chaque étape est terminée. Elle est incluse dans les forfaits Starter, Pro et Business.

Q: Combien coûte l’API ?

Rien en plus de ton forfait, à partir de $7/mo avec facturation annuelle. Chaque traitement utilise l’une des vidéos AI Clips mensuelles incluses dans ton forfait : 10 avec Starter, 50 avec Pro et 100 avec Business. Pas de frais par minute ni par requête. L’offre gratuite n’inclut pas l’API.

Q: Quelles vidéos puis-je envoyer ?

Des liens YouTube publics de 2 à 150 minutes. Les vidéos privées, réservées aux membres ou soumises à une restriction d’âge ne peuvent pas être lues. Pour créer des clips à partir d’un fichier sur ton ordinateur, importe-le depuis le site.

Q: Combien de temps dure une génération ?

Environ 10 à 15 minutes pour une vidéo longue. Ajoute un webhook pour l’événement run.completed afin d’être averti quand le traitement est terminé, ou consulte GET /v1/runs/{id}, qui indique aussi la progression en %.

Q: Que renvoie l’API ?

Pour chaque clip : son identifiant, son titre, sa description, son score de viralité sur 100, ses points de début et de fin dans la vidéo source, sa durée, un lien d’aperçu et un lien pour le modifier dans StoryCut. L’export génère un MP4 en 9:16, jusqu’en 1080p, sans filigrane.

Q: Comment vérifier qu’un webhook vient de StoryCut ?

Chaque webhook contient un en-tête X-StoryCut-Signature : sha256= suivi du HMAC-SHA256 du corps brut de la requête, calculé avec le secret de ton webhook. Calcule la même valeur sur ton serveur et compare-les. Réponds avec un statut 2xx dans les 10 secondes ; sinon, StoryCut réessaie après 10 secondes, puis après 1 minute.

Q: Puis-je modifier un clip avant de l’exporter ?

Oui. Ouvre le lien de modification du clip dans l’éditeur StoryCut, change les sous-titres ou ajoute des zooms, de la musique ou des effets sonores. Le prochain export via l’API reprendra ces modifications.

Q: Y a-t-il des limites de débit ?

120 requêtes par minute et par clé API. Le nombre de traitements est limité par les vidéos AI Clips mensuelles de ton forfait ; GET /v1/usage t’indique combien il t’en reste.

Q: Comment se compare-t-elle aux API d’OpusClip, Submagic et Vizard ?

Tous créent des clips à partir d’un lien YouTube. L’API StoryCut démarre à $9/mo ($7/mo avec la facturation annuelle) et compte les traitements, pas les minutes : un podcast de 90 minutes correspond à une vidéo mensuelle de ton forfait. Au 21 octobre 2026, l’API OpusClip est incluse dans son forfait Pro ($29 par mois, ou $14.50 avec la facturation annuelle), avec jusqu’à 15 heures de création de clips par API par mois. Submagic inclut 10 à 100 minutes d’API par mois, avec des packs à partir de $57, et Vizard utilise les minutes de vidéos importées de ton forfait. Le tableau ci-dessus renvoie vers chaque source.

Q: OpusClip propose-t-il une API ?

Oui. D’après la documentation d’OpusClip (vérifiée le 21 octobre 2026), l’accès à l’API est inclus dans ses forfaits Pro (bêta), Max et Business. L’utilisation est facturée en crédits d’une minute chacun, avec un minimum de 10 crédits par projet. L’API StoryCut est incluse dès le forfait Starter, à $7/mo avec facturation annuelle.

Envoie un lien YouTube. StoryCut trouve les meilleurs moments, recadre la vidéo au format 9:16 autour de la personne qui parle, ajoute des sous-titres animés et attribue un score à chaque clip. Récupère les clips, exporte-les en MP4 et reçois un webhook à la fin de chaque étape.

Obtenir ta clé API

Inclus dans Starter, Pro et Business
Pas de frais d’API à la minute
Webhooks signés

Mis à jour le 21 octobre 2026

L’API StoryCut : les infos clés

Ce qu’il fait: Transforme une vidéo YouTube en jusqu’à 12 clips verticaux, chacun avec des sous-titres animés, un titre et un score de viralité de 0 à 100, puis exporte n’importe quel clip en MP4.
Vidéo source: Un lien YouTube public de 2 à 150 minutes (si la vidéo est plus longue, seules ses 150 premières minutes sont utilisées). Durée des clips : courts (15–30 s), moyens (30–59 s) ou longs (60–89 s).
Résultat: Un fichier JSON avec le titre, le score, le début et la fin de chaque clip, ainsi qu’un lien d’aperçu et un lien de modification. Les exports sont des fichiers MP4 au format 9:16, jusqu’en 1080p et sans filigrane, avec un lien de téléchargement valable 24 heures.
Webhooks: run.completed, run.failed, export.completed et export.failed, chacun signé avec HMAC-SHA256. Jusqu’à 5 points de terminaison par compte.
Tarif: Inclus dans Starter ($7/mo facturé annuellement), Pro et Business. Chaque exécution utilise une vidéo AI Clips du forfait : 10, 50 ou 100. Pas de frais à la minute.
Limites: 120 requêtes par minute et par clé API. Une exécution prend environ 10 à 15 minutes.

Ce que fait l’API StoryCut

L’API utilise le même moteur AI Clips que le site StoryCut. Tu envoies un lien YouTube ; l’IA analyse la transcription, sélectionne les moments avec une accroche percutante et une idée complète, recadre chacun au format vertical autour des visages et de la personne qui parle, ajoute des sous-titres animés et attribue un score de viralité. Ton code récupère les clips, classés du meilleur au moins bon, puis exporte ceux qu’il choisit.

Tout est enregistré dans ton compte StoryCut. Chaque clip dispose aussi d’un lien de modification : ouvre-le dans l’éditeur StoryCut pour changer le style des sous-titres ou ajouter des zooms, de la musique ou des effets sonores. Les prochaines exportations via l’API tiendront compte de ces modifications.

Pour les développeurs

D’un lien YouTube à un MP4 en trois appels

Envoie ta clé API comme jeton Bearer. Chaque réponse est au format JSON ; les erreurs sont renvoyées sous la forme { "error": { "code", "message" } } avec le code d’état HTTP.

# 1. Start a run
curl https://app.storycut.com/v1/runs \
  -H "Authorization: Bearer $STORYCUT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"youtube_url": "https://www.youtube.com/watch?v=VIDEO_ID", "clip_length": "short"}'

# 2. About 10-15 minutes later (or on the run.completed webhook): the clips, best first
curl https://app.storycut.com/v1/runs/RUN_ID/clips -H "Authorization: Bearer $STORYCUT_KEY"

# 3. Export a clip, then get its download link
curl -X POST https://app.storycut.com/v1/clips/CLIP_ID/export -H "Authorization: Bearer $STORYCUT_KEY"
curl https://app.storycut.com/v1/exports/EXPORT_ID -H "Authorization: Bearer $STORYCUT_KEY"

URL de base : https://app.storycut.com/v1. La documentation complète, tes clés et tes webhooks sont dans StoryCut, sous API & Integrations.

Points de terminaison

POST /v1/runs

Lance une exécution à partir d’un lien YouTube, avec la durée de clip de ton choix. Renvoie immédiatement l’identifiant de l’exécution.

GET /v1/runs/{id}

Statut de l’exécution (processing, completed ou failed), progression en % et nombre de clips.

GET /v1/runs/{id}/clips

Les clips, classés du meilleur au moins bon : titre, score, début et fin, lien d’aperçu et lien de modification.

POST /v1/clips/{id}/export

Exporte un clip avec ses sous-titres et les modifications enregistrées. GET /v1/exports/{id} renvoie le lien de téléchargement.

Webhooks

Quand une exécution ou une exportation se termine ou échoue, StoryCut envoie une requête POST signée à ton serveur. Plus besoin de vérifier constamment.

GET /v1/usage

Ton forfait et ce qu’il te reste pour le mois, pour permettre à un script de s’arrêter avant d’atteindre la limite.

Ton code

Ton code lance l’exécution. Un webhook t’indique quand elle est terminée.

Une exécution prend environ 10 à 15 minutes : inutile d’attendre. Configure un webhook et StoryCut appelle ton serveur avec run.completed lorsque les clips sont prêts, puis avec export.completed et le lien de téléchargement une fois le clip exporté. Chaque requête est signée avec le secret de ton webhook : ton serveur peut ainsi vérifier qu’elle provient bien de StoryCut.

Code qui lance une exécution StoryCut et traite ses webhooks, à côté des clips terminés avec leurs scores de viralité et d’un événement export.completed contenant un lien de téléchargement

Comment ça marche

Bien démarrer avec l’API

01
Créer une clé
Avec un forfait Starter, Pro ou Business, ouvre API & Integrations dans StoryCut et clique sur Create key. La clé ne s’affiche qu’une seule fois : conserve-la dans l’environnement de ton serveur.
02
Lancer une exécution
Envoie POST /v1/runs avec un lien YouTube. La réponse contenant l’identifiant de l’exécution arrive immédiatement.
03
Récupérer les clips
Attends le webhook run.completed ou vérifie GET /v1/runs/{id}. Récupère ensuite les clips, classés du meilleur au moins bon.
04
Exporte
Envoie POST /v1/clips/{id}/export. Le lien de téléchargement arrive avec export.completed ou via GET /v1/exports/{id}.

Ce que tu peux automatiser

Workflows pour podcasts et webinaires

Un nouvel épisode est publié, ton script envoie le lien et les meilleurs clips sont prêts environ 15 minutes plus tard.

Workflows n8n et Make

Appelle l’API depuis une étape de requête HTTP et lance l’étape suivante à partir du webhook : aucun code à héberger.

Agences

Traite chaque vidéo client avec les mêmes étapes, puis ouvre un clip dans l’éditeur StoryCut quand il faut l’intervention d’une personne.

Assistants IA

Tu préfères passer par une conversation ? Les mêmes exécutions peuvent être lancées depuis Claude ou ChatGPT avec le connecteur MCP StoryCut, quel que soit ton forfait.

Comparatif des API de découpage vidéo

Comparatif des API de découpage vidéo : prix, utilisation, webhooks et limites, d’après les pages de tarifs et la documentation de chaque outil, vérifiés le 2026-10-21
Fonctionnalité	StoryCut	OpusClip	Submagic	Vizard	Klap
API incluse à partir de	Starter : $9/mo ($7/mo avec facturation annuelle)	Pro : $29/mo ($14.50/mo avec facturation annuelle)	Starter : $19/mo ($12/mo avec facturation annuelle)	Creator : $29/mo ($14.50/mo avec facturation annuelle)	Paiement à l’usage : $0.32 par Short, $0.44 par vidéo, $0.48 par export
Comment l’utilisation de l’API est comptabilisée	Exécutions : les 10, 50 ou 100 vidéos longues par mois incluses dans le forfait, quelle que soit leur durée, jusqu’à 150 min	Crédits, 1 par minute, 10 minimum par projet ; jusqu’à 15 heures par mois avec Pro	De 10 à 100 minutes d’API par mois, puis des packs à partir de $57 pour 250 minutes	Les minutes d’importation incluses dans le forfait, 1 crédit par minute (600 par mois avec Creator)	Par opération
Clips à partir d’un lien YouTube	Oui	Oui	Oui	Oui	Oui
Webhooks	Ouisigné avec HMAC-SHA256	Ouisigné	Oui	Ouidéfini dans l’espace de travail	Nonla documentation indique une vérification périodique
Limite de débit	120 requêtes par minute	30 requêtes par minute	Non précisé	3 par minute avec Creator	Non précisé
Connecteur Claude & ChatGPT (MCP)	Ouitous les forfaits	Oui	Oui	Non vérifié	Non vérifié