Pour les développeurs et les SaaS

Ajoute la vidéo IA à ton produit en quelques appels

Une API REST, un serveur MCP et des webhooks : ton produit crée des vidéos explicatives et découpe des vidéos longues en shorts, sans que tes utilisateurs ouvrent ClipOnIt.

Plan Starter ou plus · la clé se crée dans Réglages → Intégrations

Trois façons de s'en servir

Les deux produits de ClipOnIt, appelés depuis ton code ou par un agent.

  • AI Explainer

    Un outil de formation : une vidéo explicative par leçon

    Ton produit envoie le titre ou le texte de la leçon ; ClipOnIt écrit les scènes, les illustre, pose la voix et les sous-titres, puis rend un MP4 vertical que tu affiches à côté du cours.

    POST /api/agent/produce

  • Smart Clipper

    Une plateforme de podcast : les shorts de chaque épisode

    À chaque épisode publié, ton serveur envoie le lien de la vidéo ; ClipOnIt trouve les meilleurs moments, les note sur 100, les recadre en 9:16 et les sous-titre. Tu exportes ceux que tu veux.

    POST /api/videos/url

  • MCP

    Un agent IA qui pilote ClipOnIt

    Ton agent (Claude, Cursor, VS Code ou le tien) se branche sur le serveur MCP : il importe une vidéo, choisit les clips, lance une vidéo explicative et attend le résultat avec des outils déjà décrits.

    POST /mcp

Toujours le même flux

Une vidéo prend des minutes, pas des millisecondes : tu crées une tâche, tu suis son état, tu récupères le fichier.

  1. Créer la tâche

    Un POST avec le sujet ou le lien de la vidéo. Réponse immédiate avec un identifiant.

  2. Suivre l'état

    Un GET toutes les 10 s environ : étape, pourcentage, temps restant. Pour l'Explainer, un webhook peut te prévenir à la place.

  3. Récupérer la vidéo

    Une fois terminé, l'URL du MP4 est dans la réponse. Télécharge-le ou affiche-le dans ton produit.

AI Explainer

Une vidéo explicative à partir d'un sujet

POST /api/agent/produce reçoit un sujet (ou un script, ou un enregistrement audio) et lance l'écriture puis le rendu. GET /api/jobs/{id} renvoie status, step, percent, puis url quand la vidéo est prête.

  • duration_s15 à 180 secondes
  • style22 styles visuels, et le tien : GET /api/explainer/styles
  • voiceune voix du catalogue, par nom ou identifiant
  • dry_runtrue : vérifie le quota et le coût sans rien lancer
curl -s -X POST https://cliponit.app/api/agent/produce \
  -H "Authorization: Bearer $CLIPONIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"topic": "La photosynthèse en 3 étapes", "duration_s": 45}'

curl -s https://cliponit.app/api/jobs/JOB_ID \
  -H "Authorization: Bearer $CLIPONIT_API_KEY"

curl -s -o lecon.mp4 "URL_DU_JOB"

Smart Clipper

Les shorts d'une vidéo longue

POST /api/videos/url importe un lien (YouTube ou fichier vidéo en https) ; POST /api/videos accepte aussi un envoi de fichier. Quand state vaut ready, clips contient les moments trouvés, chacun avec score, title et reason.

POST /api/clips/{id}/export rend le clip recadré et sous-titré (orientation vertical ou horizontal) ; GET /api/exports/{id} donne url une fois terminé.

curl -s -X POST https://cliponit.app/api/videos/url \
  -H "Authorization: Bearer $CLIPONIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/episode-42.mp4"}'

curl -s https://cliponit.app/api/videos/VIDEO_ID \
  -H "Authorization: Bearer $CLIPONIT_API_KEY"

curl -s -X POST "https://cliponit.app/api/clips/CLIP_ID/export?orientation=vertical" \
  -H "Authorization: Bearer $CLIPONIT_API_KEY"

curl -s https://cliponit.app/api/exports/EXPORT_ID \
  -H "Authorization: Bearer $CLIPONIT_API_KEY"

MCP

Un serveur MCP pour les agents

Adresse unique https://cliponit.app/mcp, en HTTP « streamable ». Les outils couvrent les deux produits : importer, attendre, créer et exporter des clips, produire une vidéo explicative et attendre sa fin. Ceux qui modifient quelque chose sont annotés pour que l'agent demande avant.

Claude Desktop et Claude.ai : Réglages → Connecteurs → Ajouter un connecteur personnalisé, avec l'adresse ci-dessus. La connexion se fait par OAuth, sans clé à copier ; ChatGPT fonctionne de la même façon. Pas à pas

claude mcp add --transport http cliponit https://cliponit.app/mcp \
  --header "Authorization: Bearer $CLIPONIT_API_KEY"

Être prévenu au lieu de demander

Dans Réglages → Intégrations, ajoute jusqu'à 3 URL https. Quand une production Explainer se termine, ClipOnIt y envoie job.done ou job.failed, avec le même objet que GET /api/jobs/{id}. Six essais en cas d'échec, sur 8 heures environ.

Pour les clips Smart Clipper, il n'y a pas encore de webhook : suis l'état avec GET.

import hashlib, hmac, time

def verify(secret: str, header: str, body: bytes, tolerance: int = 300) -> bool:
    """header = X-ClipOnIt-Signature, body = raw request bytes."""
    parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
    if abs(time.time() - int(parts.get("t", 0))) > tolerance:
        return False
    mac = hmac.new(secret.encode(), parts["t"].encode() + b"." + body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(mac, parts.get("v1", ""))

Limites et quotas par plan

Les appels API comptent comme dans l'interface : mêmes quotas, même compte. Voir les tarifs

FreeStarterProBusiness
API et MCP—✓✓✓
Vidéos Smart Clipper par mois22060200
Minutes de vidéo source par mois404809002 400
Vidéos Explainer par mois—1530100
Productions Explainer en même temps—222
Clés API par compte—101010
Webhooks par compte—333

Sécurité

Appelle ClipOnIt depuis ton serveur, jamais depuis le navigateur de tes utilisateurs.

Politique de confidentialité
  • La clé reste sur ton serveur.Elle donne accès au compte ClipOnIt entier : jamais dans le navigateur, une appli mobile ou un dépôt Git. Garde-la dans une variable d'environnement et appelle ClipOnIt depuis ton backend.
  • Une clé par usage, avec sa portée.Portée « lecture » (consulter, vérifier) ou « production » (créer des vidéos). Chaque clé a un nom, une date de dernière utilisation et se révoque d'un clic : elle répond 401 dès l'appel suivant.
  • Le secret n'est montré qu'une fois.ClipOnIt n'en garde que l'empreinte (SHA-256). Perdue, une clé se remplace, elle ne se relit pas.
  • Webhooks signés.Chaque envoi porte X-ClipOnIt-Signature (HMAC-SHA256 du corps et de l'horodatage) ; refuse tout envoi de plus de 5 minutes. Les URL de réception sont en https et vérifiées à chaque envoi.
  • Hébergé dans l'Union européenne.Serveurs Hetzner en UE ; sous-traitants listés dans la politique de confidentialité.

Preguntas frecuentes

SDK, widget, délais, quotas et volume.

Quel plan faut-il pour l'API ?

Starter ou plus. Le plan gratuit n'a pas d'accès API ni MCP : une clé ne peut pas être créée et le serveur MCP répond « plan sans accès API ». Les quotas de l'API sont ceux du compte, comme dans l'interface.

Y a-t-il un SDK ?

Pas de SDK officiel pour l'instant. L'API est en HTTP et JSON, décrite en OpenAPI 3.1 (/openapi.json) : les exemples de cette page tiennent en quelques lignes de fetch ou de Python standard, et tu peux générer un client depuis le fichier OpenAPI.

Puis-je intégrer un lecteur ou un éditeur ClipOnIt dans mon site ?

Non, il n'y a pas de widget embarquable. Tu récupères le fichier MP4 et tu l'affiches dans ton propre lecteur, ou tu l'héberges chez toi.

Combien de temps prend une vidéo ?

Une vidéo explicative : quelques minutes (écriture puis rendu, environ 4 min pour le rendu). Des clips : environ 1 à 5 minutes pour 20 minutes de vidéo, puis l'export de chaque clip. L'API renvoie l'étape, le pourcentage et une estimation du temps restant.

Que se passe-t-il quand un quota est atteint ?

L'API répond 402 avec un message clair (quota du mois ou budget IA), 403 si la fonction n'est pas dans le plan, 429 si deux productions Explainer tournent déjà. Pour l'Explainer, « dry_run »: true vérifie tout avant de lancer, sans rien créer ni facturer.

Je veux brancher ClipOnIt pour tous mes utilisateurs.

Une clé agit sur un seul compte ClipOnIt : les vidéos et les quotas sont ceux de ce compte. Pour un usage à plus grande échelle, écris-nous à contact@cliponit.app avec ton volume et ton cas d'usage.

Ta première vidéo par l'API, aujourd'hui

Crée une clé, copie un exemple, lance-le. Une question sur ton intégration : contact@cliponit.app.

llms-api.txt · OpenAPI 3.1 · mcp.json