API Modipho — mode d’emploi pour les IA

Modipho (https://modipho.com) est un studio français qui fabrique des vidéos publicitaires courtes et verticales (Reels, TikTok, Shorts) à partir d’une simple demande écrite. Un compte Modipho peut créer des clés API (Paramètres › Clés API) : chaque clé est une adresse de la forme https://modipho.com/ia/mdpk_…. Ouvrir cette adresse donne ce mode d’emploi avec la description de la clé.

English summary: Modipho is an AI studio for short vertical promo videos. A Modipho API key looks like https://modipho.com/ia/mdpk_…; send it as Authorization: Bearer mdpk_… to https://modipho.com/api/v1.

Ce que tu peux faire

Appel	Rôle
`GET https://modipho.com/api/v1/moi`	Le compte : vidéos restantes aujourd’hui, droits et limites de la clé. Commence par là.
`GET https://modipho.com/api/v1/videos`	Les vidéos du compte (les plus récentes d’abord) : id, sujet, état, durée, format.
`POST https://modipho.com/api/v1/videos`	Crée une vidéo à partir d’une demande écrite.
`GET https://modipho.com/api/v1/videos/{id}`	L’état d’une vidéo et, quand elle est prête, son lien de téléchargement.
`GET https://modipho.com/api/v1/videos/{id}/fichier`	Le fichier MP4 de la vidéo terminée.
`GET https://modipho.com/api/v1/openapi.json`	La description technique complète (OpenAPI 3.1).

Créer une vidéo

Corps JSON : texte (obligatoire, la demande en langage naturel, en français de préférence : sujet, ton, durée, format, voix…), marque (facultatif, le nom du commerce), site (facultatif, l’adresse du site du commerce : Modipho le lit pour être exact).

curl -s -X POST https://modipho.com/api/v1/videos \
  -H "Authorization: Bearer <CLÉ>" -H "Content-Type: application/json" \
  -d '{"texte":"Une vidéo de 30 secondes pour présenter notre café, ton chaleureux, voix féminine","marque":"Café Boréal","site":"https://exemple.fr"}'

Réponse : {"video": {"id": "…", "etat": "en_attente", …}}. Si le sujet manque, la réponse est {"question": "…"} : pose cette question à l’utilisateur puis renvoie une demande plus précise.

Suivre et récupérer la vidéo

curl -s https://modipho.com/api/v1/videos/ID -H "Authorization: Bearer <CLÉ>"
curl -s -o video.mp4 https://modipho.com/api/v1/videos/ID/fichier -H "Authorization: Bearer <CLÉ>"

États : en_attente / pret_pour_ouvrier (dans la file), en_cours / fabrication (le studio fabrique : 10 à 25 minutes), termine (prête si bloquee est faux ; telechargement donne le lien), annule. Si bloquee est vrai, le contrôle final a refusé la vidéo : raisons explique pourquoi, rien n’est livré. Interroge au plus une fois par minute.

Règles

Chaque vidéo passe le contrôle final de Modipho (droits des images et musiques, sécurité, qualité). Les contenus interdits sont refusés.
La clé ne publie rien sur les réseaux sociaux : la publication reste dans l’application, avec l’accord du propriétaire.
Limites : celles du compte (vidéos par 24 h) et, si elle en a une, celle de la clé. Au-delà : réponse 429, réessaie plus tard.
Erreurs : 401 clé inconnue, révoquée ou expirée · 403 droit manquant ou compte suspendu · 404 vidéo introuvable · 429 limite atteinte · 400 demande invalide. Le corps contient toujours {"error": "message lisible"}.
Le propriétaire peut révoquer la clé à tout moment (Paramètres › Clés API).