API & MCP

Documentation

Toute la plateforme Deklip est pilotable par API REST et par MCP. Cette documentation détaille chaque concept, chaque endpoint et chaque outil, avec des exemples.

Démarrage rapideVotre première vidéo par API en 5 minutes.AuthentificationOAuth pour Claude, clés Bearer pour l'API.Jobs asynchronesSuivre les générations via polling ou webhook.MCPConnecter un assistant et ses 66 outils.

Concepts

Introduction, L'API Deklip permet de faire par programme tout ce que fait l'interface, et le serveur MCP l'ouvre à vos assistants IA.
Démarrage rapide, Votre première vidéo générée par API en cinq minutes.
Authentification, OAuth pour les assistants (MCP), clés Bearer pour l'API REST.
Permissions (scopes), Chaque clé porte un ou plusieurs scopes; chaque endpoint en exige un.
Crédits & coûts, L'API consomme les crédits de votre compte. Les coûts sont fixes par action.
Jobs asynchrones, Les générations longues renvoient un job_id et se suivent par polling ou webhook.
Webhooks, Soyez notifié à la fin d'un job, sans poller.
Idempotence, Évitez les doublons et les double-débits sur les créations de jobs.
Limites & pagination, Rate limit, plafond de crédits et pagination des listes.
Erreurs, Format des erreurs et codes possibles.

MCP, 66 outils

Le serveur MCP https://deklip.com/mcp expose 66 outils qui reprennent l'API. Une page par outil :

API, 70 endpoints

Base https://deklip.com/v1. Une page par endpoint, avec paramètres et exemples :

Compte & référentiel

Consulter le compte, la grille de prix, la consommation et les référentiels (voix).

GET/v1/meRécupère le compte courant.GET/v1/pricingGrille des coûts par action.GET/v1/usageVotre consommation API.GET/v1/voicesVoix off disponibles.

Briefs

Le brief est le point de départ: il décrit votre produit, votre audience et votre objectif. On génère ensuite des angles, puis des vidéos.

GET/v1/briefsListe vos briefs.POST/v1/briefsCrée un brief.GET/v1/briefs/{id}Détail d'un brief.PUT/v1/briefs/{id}Modifie un brief.DELETE/v1/briefs/{id}Supprime un brief.GET/v1/briefs/{id}/anglesAngles d'un brief.POST/v1/briefs/{id}/anglesGénère une série d'angles (hooks + scripts).POST/v1/brief-scanCrée un brief depuis une capture d'écran.

Angles

Un angle porte un hook et un script. C'est l'unité qu'on transforme en vidéo, qu'on itère et dont on remonte les performances.

PUT/v1/angles/{id}Modifie un angle (hook, script).DELETE/v1/angles/{id}Supprime un angle.POST/v1/angles/{id}/perfRenseigne les performances d'un angle.POST/v1/angles/{id}/perf-scanExtrait les stats d'une capture analytics.POST/v1/angles/{id}/iterateDécline un angle gagnant.POST/v1/angles/{id}/videoGénère la vidéo complète d'un angle.

Vidéos & jobs

Un job représente une génération (vidéo, clip, avatar…). Vous suivez son statut, téléchargez le résultat, le dupliquez ou le partagez.

GET/v1/jobsListe des jobs récents.GET/v1/dashboardTous vos contenus, organisés par type.GET/v1/jobs/{id}Statut d'un job.DELETE/v1/jobs/{id}Supprime une vidéo.GET/v1/jobs/{id}/downloadTélécharge le MP4.POST/v1/jobs/{id}/duplicateDuplique une vidéo.POST/v1/jobs/{id}/publishedActive/désactive le partage public.POST/v1/jobs/{id}/hooksVariantes A/B de hook.POST/v1/jobs/{id}/viralcheckScore viral + recommandations.POST/v1/jobs/{id}/pubkitKit de publication (titre, description, hashtags).POST/v1/jobs/{id}/shareCrée un lien de partage public.

Éditeur

Chaque vidéo a une timeline JSON éditable (scènes, voix, sous-titres, musique, overlays). Modifiez-la puis re-montez. Toutes ces routes exigent le scope edit.