L'API et l'automatisation

L'API te permet de piloter ton compte Moqi depuis ton propre code, un outil d'automatisation ou un agent comme Claude, sans ouvrir le site. Le plus courant : tu envoies un lien YouTube ou un fichier vidéo, Moqi te renvoie un identifiant, puis tu viens chercher les clips finis avec leur lien de téléchargement, leur description et leurs hashtags. Mais presque tout ce que tu fais sur le site s'y fait aussi : demander le prix avant de lancer, fabriquer un moment écarté, renommer ou supprimer une vidéo ou un clip, générer une vidéo ou une image, publier et programmer sur TikTok, régler ton style et ton fuseau, lire tes statistiques et écrire au support. Ce qui reste sur le site : payer, changer d'abonnement, tes réglages de publication TikTok, tes clés et ton mot de passe. La documentation complète, avec les exemples, est sur la page Développeurs du site.

Aucune. L'API, le serveur MCP, les crochets et le connecteur Moqi pour Claude sont ouverts à tous les comptes, avec ou sans formule, pendant le premier mois à 0,99 € compris : tu crées ta clé depuis ta page API et tu t'en sers tout de suite. Ce qui décide, c'est ton solde de Moqi, parce qu'un appel qui lance un découpage le paie exactement comme une génération lancée depuis le site. Si ton solde ne suffit pas, l'appel est refusé avant de rien démarrer et rien ne t'est décompté. Ton ticket d'essai, lui, se dépense seulement sur moqi.fr, jamais par l'API ni par Claude.

Dans Claude, ouvre Personnaliser, puis Connecteurs, et choisis « Ajouter un connecteur personnalisé ». Colle l'adresse https://moqi.fr/api/mcp et valide avec « Se connecter maintenant ». Une fenêtre Moqi s'ouvre, tu vérifies ce que tu autorises, tu cliques sur Autoriser, et c'est fait. Tu n'as aucune clé à copier. La connexion apparaît ensuite sur ta page API sous le nom Claude, avec un plafond de 1 000 Moqi par jour que tu peux changer, et tu la coupes d'un clic quand tu veux. Une fois connecté, Claude fait presque tout ce que tu fais sur le site : découper, générer, publier et programmer sur TikTok, régler ton style, renommer ou supprimer une vidéo. Ce qu'il lance se paie en Moqi, comme depuis le site, et il te demande ton accord avant chaque action qui coûte ou qui supprime. Dans Claude Code, c'est la commande claude mcp add --transport http moqi https://moqi.fr/api/mcp, puis /mcp pour te connecter. Tout est repris pas à pas sur la page Moqi dans Claude, à l'adresse moqi.fr/claude.

Ouvre la page API de ton espace, par l'entrée API du menu, et clique sur « Créer une clé ». La clé commence par moqi_live_ et ne s'affiche qu'une seule fois : copie-la immédiatement et range-la dans les variables d'environnement de ton projet, jamais dans du code envoyé sur un dépôt public. Ensuite tu ne verras plus que son début, le reste reste masqué, et personne chez Moqi ne peut te la relire. Tu peux avoir 5 clés actives au maximum sur ton compte.

Sur la page API de ton espace, chaque clé a un bouton « Révoquer », qui te demande de confirmer. La révocation prend effet tout de suite : tout appel fait avec cette clé répond 401 invalid_api_key. Pour tourner sans coupure, crée d'abord la nouvelle clé, déploie-la dans ton projet, vérifie qu'un appel passe, et révoque l'ancienne seulement après. Si tu as déjà 5 clés actives, révoques-en une avant d'en créer une nouvelle.

Tu fais un POST sur https://moqi.fr/api/v1/decoupages avec l'en-tête Authorization qui vaut Bearer suivi de ta clé (x-api-key marche aussi), et un corps JSON qui contient au moins le champ url. Tu peux ajouter clipCount (nombre de clips voulus, jusqu'à 15), clipMax (durée maximale d'un clip, de 20 à 120 secondes) et hook (true pour incruster une accroche en haut de l'image) ; une valeur hors bornes est ramenée à la borne, pas refusée. Deux options en plus : sous_titres (false retire les sous-titres animés, c'est moins cher) et langue_sous_titres (fr, en, es, pt, de, it : traduits dans cette langue, c'est payant). Les clips sortent dans la direction artistique réglée dans Mon style, exactement comme depuis le site. Pour connaître le prix avant de lancer, fais un GET sur https://moqi.fr/api/v1/decoupages/devis avec les mêmes réglages : il te dit combien ça coûte et ce qui te reste. Ensuite, relis https://moqi.fr/api/v1/decoupages/ suivi de l'identifiant reçu au rythme que donne sonder_dans_s, ou laisse Moqi te rappeler avec un crochet.

YouTube et Twitch. Côté YouTube : youtube.com, youtu.be, m.youtube.com et music.youtube.com, y compris les formats /shorts/, /embed/ et /live/. Un lien de direct en /live/ est accepté, et c'est l'état du direct qui décide : terminé et rediffusé, il se découpe comme une autre vidéo ; encore en cours, ou sans rediffusion prête, le découpage finit en echoue avec la raison dans echec.message, et ce qu'il avait coûté t'est rendu. Avec toute_la_video, ce refus arrive tout de suite, en 400 live_url, avant tout débit. Côté Twitch : une rediffusion twitch.tv/videos/ suivi de son numéro, ou un clip, écrit clips.twitch.tv/ ou twitch.tv/lachaine/clip/. L'adresse d'une chaîne Twitch toute seule, qui est aussi son direct, ne ressemble à aucune forme connue et répond 400 invalid_url. Pour un direct, attends sa fin et reprends le lien de l'enregistrement. Tout autre lien, un fichier hébergé ailleurs par exemple, répond 400 invalid_url. Pour une vidéo qui est sur ton ordinateur, envoie le champ fichier avec son nom (mp4, mov, webm…) à la place de url : la réponse te donne une adresse où envoyer le fichier par un PUT, valable deux heures, et le découpage part tout seul une fois le fichier arrivé. Sans fichier au bout de deux heures, il est annulé et ce qu'il avait coûté t'est rendu.

Le POST répond en 201 avec id, status (pending, ou attente_du_fichier pour un fichier), suivre et langue_sous_titres, la langue retenue. suivre est un chemin relatif : colle-le derrière https://moqi.fr pour obtenir l'adresse à relire, https://moqi.fr/api/v1/decoupages/ suivi de l'id. Ce GET renvoie id, cree_le, etat (en_attente, en_cours, fini ou echoue), etat_brut, avancement de 0 à 100, source, titre et un tableau clips. Tant que le découpage n'est pas terminé, il porte aussi sonder_dans_s, le délai avant de relire ; un échec porte echec.message. Le tableau clips se remplit quand etat vaut fini : chaque clip contient position, titre, duree_s, description, hashtags, score, raison_du_score, vignette_url et fichier_url. La réponse du POST garde aussi statusUrl, l'ancienne adresse /api/v1/clips/ suivi de l'id : elle répond toujours, dans son format d'origine (status, downloadUrl), pour les intégrations qui la lisent déjà.

Le POST répond immédiatement : il ne fait que créer le découpage et le lancer, il n'attend pas les clips. La fabrication elle-même prend quelques minutes, selon la durée de la vidéo et le nombre de clips demandés. Relis https://moqi.fr/api/v1/decoupages/ suivi de l'id au rythme que donne sonder_dans_s (10 secondes tant qu'il attend, 5 quand il avance), jusqu'à ce que etat vaille fini ou echoue. Entre les deux, etat vaut en_attente puis en_cours ; etat_brut donne l'étape exacte, et relay_pending ou relaying y sont des étapes normales de récupération de la vidéo : continue d'attendre. Tu peux aussi laisser Moqi te rappeler avec un crochet, sans relire du tout.

Oui, fichier_url et vignette_url (downloadUrl et thumbUrl sur l'ancienne adresse /api/v1/clips/) sont des liens signés, valables au moins une heure. Passé ce délai, relis simplement le découpage, https://moqi.fr/api/v1/decoupages/ suivi de l'id : il te donne des liens neufs. Les fichiers eux-mêmes restent 7 jours sur nos serveurs pour un abonné au plein tarif, et le compte à rebours démarre au lancement de la génération, pas à la livraison des clips. Ensuite ils sont supprimés. Télécharge et range tes fichiers chez toi dès que la génération est terminée.

Oui, c'est un seul et même solde. Chaque POST accepté débite des Moqi exactement comme une génération lancée depuis le site, au même prix et sur la même enveloppe : il n'y a pas un compteur pour l'API et un autre pour le site. Une fois ton solde épuisé, l'API répond 402 quota_exceeded jusqu'à ton prochain renouvellement ou ta prochaine recharge.

Par l'API, la limite qui compte vraiment, c'est 3 vidéos en cours de traitement en même temps, et le compteur est COMMUN : une vidéo lancée depuis le site occupe une des trois places. Si tu envoies un quatrième POST pendant que trois tournent, tu reçois 429 too_many_active. Attention à l'inverse : le SITE, lui, n'accepte qu'une seule génération à la fois, donc tant qu'une vidéo tourne, quelle que soit la porte par laquelle tu l'as lancée, la page de génération refusera d'en démarrer une autre. Gère une file d'attente de ton côté : tu envoies, tu attends que son etat vaille fini, tu envoies la suivante.

Chaque erreur revient en JSON avec un code stable et un message écrit pour un humain : teste le code dans ton programme, jamais le message. Il y a deux formes. Le POST qui lance un découpage (https://moqi.fr/api/v1/decoupages, comme son adresse d'origine /api/v1/clips) répond { error, message } pour ses refus historiques : 400 missing_url, invalid_url ou live_url ; 402 quota_exceeded, avec manque et reste ; 403 email_required ; 429 rate_limited ou too_many_active ; 500 create_failed (503 quand le service est momentanément indisponible), et tes Moqi te sont rendus. Tout le reste répond { erreur: { code, message, reessayable } }, et reessayable te dit s'il faut recommencer : jamais, oui ou apres-action. Par exemple 401 invalid_api_key si la clé est absente, inconnue ou révoquée, 401 api_key_expired si elle a passé sa date d'expiration, 403 subscription_unpaid si une facture est impayée, 403 daily_cap_too_low si la demande coûte plus que le plafond du jour de la clé, et 404 not_found sur https://moqi.fr/api/v1/decoupages/ suivi d'un id introuvable ou qui n'est pas à toi. L'ancienne adresse de lecture, /api/v1/clips/ suivi de l'id, garde sa forme d'origine : 401 invalid_api_key, 404 job_not_found. La liste complète est sur moqi.fr/developpeurs, rubrique Erreurs.

Oui. Pour n8n, deux modèles prêts à importer sont sur moqi.fr/developpeurs : l'un découpe une vidéo et sort un élément par clip, l'autre reçoit les rappels de Moqi et vérifie leur signature. Ta clé va dans un identifiant n8n « Header Auth » (Name Authorization, Value Bearer suivi de ta clé). Pour Make, quatre étapes : un « Custom webhook » dont tu colles l'adresse dans « Rappel automatique » sur ta page API, un filtre sur l'évènement decoupage.fini, un « Make a request » en GET sur https://moqi.fr/api/v1/decoupages/ suivi de l'identifiant reçu (avec le même en-tête), puis un « Iterator » sur les clips. Zapier se monte pareil avec « Webhooks by Zapier », réservé à ses offres payantes. Chaque clip porte son lien de téléchargement, valable au moins une heure.