L'API Développeur ClipMixAI est désormais disponible

Nous ouvrons aujourd'hui les moteurs qui alimentent l'application web ClipMixAI à quiconque souhaite construire dessus. La nouvelle API Développeur disponible à api.clipmixai.com/api/v1 expose quatre services — traduction vidéo, vidéo souvenir, faceswap & avatars, et musique IA — via une surface REST à jeton Bearer unique. Mêmes modèles, même qualité, mêmes crédits. Aucun abonnement requis. Aucun minimum.

Si vous préférez passer directement à l'action : /api présente l'argumentaire, /api/docs contient la référence, et /dashboard/api-keys est l'endroit où créer votre clé.

Pourquoi nous avons construit ceci

Au cours de l'année écoulée, nous avons observé des utilisateurs payants répéter systématiquement la même chose : ouvrir le tableau de bord, téléverser 30 photos, cliquer sur créer, attendre la chanson, puis pousser manuellement le résultat vers un outil d'édition séparé. Nous avions des fondateurs qui traduisaient du contenu de créateurs en 10 langues, des agences produisant 100 spots de marque par semaine, des studios de jeux indépendants générant de la musique temporaire pour des prototypes. Chacun d'eux a fini par poser la même question : « y a-t-il une API ? »

Il y en a une maintenant. Les quatre services qui alimentaient tous ces flux de travail sont désormais appelables depuis votre code — sans passer par le tableau de bord, sans avoir à apprendre les particularités de chaque fournisseur, et avec la même tarification par crédit que vous connaissez déjà depuis l'application web. Si un flux de travail qui prenait une heure à une personne peut maintenant tourner en tâche de fond dans un CRON job, c'est là la victoire.

Démarrage rapide

Générez une clé depuis le tableau de bord, puis :

curl -X POST https://api.clipmixai.com/api/v1/music \
  -H "Authorization: Bearer sk_live_..." \
  -H "Idempotency-Key: my-fresh-key-1" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt":   "Uplifting synthwave with female vocals",
    "lyrics":   "[verse]\nRunning through neon lights...",
    "duration_seconds": 60
  }'

Vous recevez instantanément un job-id avec status: "processing". Vous pouvez soit interroger GET /v1/music/{id} jusqu'à ce que le statut passe à completed, soit — mieux — rattacher un webhook à votre clé lors de sa création, et nous enverrons le résultat terminé à votre endpoint par POST, signé avec HMAC-SHA256 pour que vous puissiez vérifier qu'il provient bien de nous.

Trois fonctionnalités que les développeurs réclamaient et que nous n'avions pas encore livrées

1. Clés sandbox

Chaque clé API a un mode : sk_live_ débite des crédits et appelle de vrais fournisseurs ; sk_test_ ne débite jamais, n'appelle jamais un fournisseur, et renvoie un job completed synthétique avec test: true dans le corps. Utilisez les clés sandbox dans votre CI pour valider votre intégration sans brûler de crédits, puis passez aux clés live quand vous voulez un vrai résultat.

Les clés sandbox sont gratuites pour tout le monde — y compris les comptes gratuits. La seule condition pour utiliser une clé live est un achat de crédits préalable, qui conditionne l'accès à l'API au même signal de paiement que l'application web.

2. Idempotency-Key sur chaque POST

Les nouvelles tentatives réseau sont le cauchemar de toute API sensible à la facturation. Nous avons emprunté la solution de Stripe : passez Idempotency-Key: <votre-chaîne> sur n'importe quel appel de création et le serveur met la réponse en cache pendant 24 heures. Une nouvelle tentative avec la même clé et le même corps renvoie la réponse originale — jamais de double débit. Une nouvelle tentative avec la même clé mais un corps différent renvoie 422 idempotency_key_reuse pour que vous trouviez le bug plutôt que de produire silencieusement un job incorrect.

Les deux SDK officiels exposent ceci via un seul argument nommé :

# Python
c.music.create(prompt=..., lyrics=..., idempotency_key="order-42")

// JS
await c.music.create({ prompt, lyrics, idempotencyKey: "order-42" });

3. Webhooks avec un bouton de test

Configurez une URL de callback sur votre clé et nous enverrons par POST les événements job.completed / job.failed au fur et à mesure que les jobs se terminent. Chaque livraison porte une signature HMAC dans X-ClipMix-Signature: sha256=<hex> — à vérifier avec un helper depuis l'un ou l'autre SDK. Les livraisons échouées sont relancées avec un backoff exponentiel (0s → 30s → 5m → 1h, quatre tentatives au total).

Le tableau de bord dispose d'un bouton Test d'envoi qui envoie un événement webhook.test synthétique pour que vous puissiez vérifier la signature et le parsing de votre endpoint sans attendre un vrai job. Le même panneau affiche un journal de 100 livraisons par clé, afin que, lorsque quelque chose tourne mal, vous n'ayez pas à deviner où ça a échoué.

Trois cas d'usage que nous observons déjà

Traduction vidéo en masse pour les créateurs

Téléversez une vidéo, obtenez 10 versions doublées en 10 langues, avec clonage de voix optionnel qui préserve le ton du locuteur. Un créateur YouTube traduit son podcast hebdomadaire en 9 langues en pilotage automatique — l'appel API est déclenché par son hook de publication existant, et le webhook dépose le fichier doublé dans son CMS.

Vidéos de marque personnalisées par client

La sortie vidéo souvenir photo-vers-vidéo permet à une boutique e-commerce de prendre la photo produit d'un client et de générer une courte publicité cinématographique personnalisée pour cette annonce. L'endpoint family-videos expose les quatre modes (Moment, Story, Album, Chronicle) que nous avons construits pour notre interface grand public ; des agences les utilisent comme moteur dans leurs outils en marque blanche.

Prototypage audio pour les jeux

Des studios indépendants appellent l'endpoint /v1/music depuis leur pipeline d'assets interne. Un game designer saisit une ambiance et un extrait de paroles temporaires, et une piste de 60 secondes atterrit dans le dossier audio du projet dix minutes plus tard. Ils itèrent sur la musique provisoire en quelques secondes au lieu d'attendre un sound designer pour chaque variation.

Versionnage + nos engagements

v1 est stable. Nous n'introduirons pas de changements cassants dans /api/v1/ — les nouveaux champs et les nouveaux endpoints sont additifs uniquement, et la surface existante reste en l'état. Tout ce que nous devons modifier (cas rare) paraît sous /api/v2/ avec une période de transition annoncée. Le journal des modifications fait foi.

Le statut opérationnel est disponible en temps réel sur /api/status — un instantané de santé par service dérivé des 5 dernières minutes de trafic réel. Il se met à jour toutes les 60 secondes et c'est la même vue que celle de notre équipe d'astreinte.

Tarification

Le même portefeuille que l'application web. 1 $ = 100 crédits, avec les bonus de volume existants sur les recharges. Une chanson de 60 secondes coûte 60 crédits (0,60 $). Un avatar tête parlante de 30 secondes coûte 450 crédits au niveau équilibré. La traduction d'une vidéo d'une minute au niveau premium coûte ~190 crédits. Les clés sandbox sont gratuites.

Des plans API à plusieurs niveaux (Pro / Business / Enterprise) avec remises sur volume et workers prioritaires sont en cours de préparation. Si vous en bénéficieriez dès aujourd'hui, laissez votre email sur /contact?topic=api-tiers et nous vous tiendrons informé à leur sortie.

Essayez

• /api — présentation en cinq minutes
• /api/docs — référence (auth, idempotence, webhooks, sandbox, erreurs, SDK)
• /api/status — santé des services en temps réel
• /api/changelog — ce qui a été livré, ce qui vient ensuite
• /dashboard/api-keys — générez votre première clé

Rapports de bugs et demandes de fonctionnalités : GitHub Issues. Pour tout le reste : support@clipmixai.com.