API Reference

ClipMachine API publique

Intégrez la génération de clips IA dans vos applications, workflows n8n, ou Zapier. Authentification par clé API, réponses JSON standardisées.

Base URL : https://clipmachine.io/api/v1Obtenir une clé API →

Authentification

Toutes les requêtes doivent inclure votre clé API dans le header Authorization.

Authorization: Bearer cm_live_YOUR_KEY_HERE

Important :Votre clé n'est affichée qu'une seule fois lors de sa création. Stockez-la de façon sécurisée. En cas de perte, révoquez et recréez une nouvelle clé.

Rate Limits

Plan

Requêtes/min

Clips/mois

Starter

10 req/min

~20 clips

Pro

10 req/min

~80 clips

Business

10 req/min

~200 clips

Endpoints

POST/api/v1/clips/generate202 Accepted

Génère des clips viraux depuis une URL vidéo

Request Body

{
  "videoUrl": "https://example.com/video.mp4",
  "platform": "tiktok",   // tiktok | reels | shorts | linkedin
  "mode": "classic"        // classic | composer
}

Response

{
  "ok": true,
  "jobId": "job_abc123",
  "statusUrl": "https://clipmachine.io/api/v1/jobs/job_abc123",
  "message": "Job créé. Interrogez statusUrl pour suivre la progression."
}

GET/api/v1/jobs/:id200 OK

Récupère le statut et les résultats d'un job

Response

{
  "jobId": "job_abc123",
  "status": "done",       // queued | transcribing | analyzing | rendering | done | error
  "clips": [
    {
      "id": "clip_001",
      "score": 8.7,
      "title": "Le moment clé du podcast",
      "duration": 23,
      "cloudinaryUrl": "https://res.cloudinary.com/..."
    }
  ],
  "createdAt": "2026-04-10T10:00:00.000Z",
  "updatedAt": "2026-04-10T10:02:30.000Z"
}

Codes d'erreur

400Bad RequestParamètres manquants ou invalides

401UnauthorizedClé API manquante ou invalide

402Payment RequiredQuota épuisé — passez à un plan supérieur

429Too Many RequestsRate limit atteint (10 req/min par clé)

500Internal Server ErrorErreur serveur — réessayez plus tard

Exemple complet — cURL

# 1. Lancer la génération
curl -X POST https://clipmachine.io/api/v1/clips/generate \
  -H "Authorization: Bearer cm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"videoUrl":"https://example.com/podcast.mp4","platform":"tiktok"}'

# → { "jobId": "abc123", "statusUrl": "..." }

# 2. Suivre le job (polling)
curl https://clipmachine.io/api/v1/jobs/abc123 \
  -H "Authorization: Bearer cm_live_YOUR_KEY"

# → { "status": "done", "clips": [...] }

Prêt à intégrer ?

Créez votre clé API en 30 secondes

Obtenir ma clé API →