Mon compte
API · formule Studio

API Moqi

Génère des clips verticaux sous-titrés automatiquement depuis ton code, ou via Make, Zapier et n8n. Tu envoies un lien, Moqi te renvoie les clips prêts à poster.

Authentification

Crée une clé API depuis ton espace compte (section « Accès API »). Passe-la dans l'en-tête Authorization de chaque requête. Garde-la secrète : elle donne accès à ton quota.

Authorization: Bearer moqi_live_xxxxxxxxxxxxxxxx

URL de base : https://moqi.fr/api/v1

Endpoints

POST/api/v1/clips

Lance la génération de clips à partir d'un lien vidéo.

Corps (JSON)

  • url : requis. Lien YouTube, podcast ou vidéo directe.
  • clipCount : optionnel. Nombre de clips voulus (plafonné par ta formule).
  • clipMax: optionnel. Durée max d'un clip, en secondes.
  • hook : optionnel. true pour incruster un hook texte en haut de la vidéo.
curl -X POST https://moqi.fr/api/v1/clips \
  -H "Authorization: Bearer moqi_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://youtu.be/xxxx",
    "clipCount": 10,
    "clipMax": 60,
    "hook": true
  }'

Réponse

{
  "id": "3c1d23fa-...",
  "status": "pending",
  "statusUrl": "/api/v1/clips/3c1d23fa-..."
}
GET/api/v1/clips/{id}

Récupère l'état d'un job et ses clips. Interroge cet endpoint toutes les quelques secondes jusqu'au statut done.

Statuts possibles

pending · processing · done · error

{
  "id": "3c1d23fa-...",
  "status": "done",
  "progress": 100,
  "clips": [
    {
      "id": "...",
      "title": "...",
      "duration": 32.5,
      "downloadUrl": "https://...",
      "thumbUrl": "https://...",
      "caption": "Texte de légende optimisé",
      "hashtags": "#nostalgie #annees90 #culturepub"
    }
  ]
}

Les liens downloadUrl et thumbUrl sont signés et valables 1 heure. Télécharge les fichiers pour les conserver.

Limites

  • Le nombre de clips et la durée sont automatiquement plafonnés selon ta formule.
  • Chaque job consomme une vidéo de ton quota mensuel.
  • L'API est incluse dans la formule Studio.

Erreurs

401invalid_api_keyClé absente ou invalide.
403api_not_availableFormule sans accès API.
400missing_urlLe champ url est manquant.
402quota_exceededQuota mensuel de vidéos atteint.
404job_not_foundJob inexistant ou non rattaché à ta clé.

Prêt à brancher Moqi ?

Crée ta clé API en quelques secondes depuis ton compte.

Créer ma clé API