Référence de l'API

Ce qu'est l'API

L'API MyDreamVid permet à votre propre logiciel de générer des vidéos et des images avec les modèles Seedance et Seedream, sans que personne ne passe par le studio. Votre programme envoie un prompt (et des fichiers de référence facultatifs), nous appliquons les mêmes contrôles de sécurité et les mêmes tarifs que le studio web, et votre programme récupère le fichier fini. Les crédits sont prélevés sur le même solde de compte.

À qui elle s'adresse

• Les équipes qui génèrent en volume : catalogues produits, variantes publicitaires, clips sociaux, versions localisées d'une même vidéo.
• Les développeurs qui ajoutent la génération de vidéo ou d'image à leur propre application, outil, bot ou pipeline interne.
• Les agences et studios qui veulent leur propre interface pendant que nous gérons modèles, files d'attente et facturation.

Si vous faites quelques vidéos par semaine à la main, vous n'avez pas besoin de l'API. Le studio fait tout ce que fait l'API, aux mêmes prix.

Authentification

Chaque requête porte une clé bearer. Les clés sont créées dans le studio et affichées une seule fois.

• Header : Authorization: Bearer mdv_live_…
• La permission write peut créer et annuler des tâches et téléverser des fichiers ; read ne peut que lister et consulter.
• Les clés sont disponibles après une recharge Creator (25 $) ou Studio (50 $). Les crédits n'expirent jamais.
• L'API est conçue pour être appelée depuis votre serveur. N'embarquez pas de clés dans du code navigateur ou mobile.

Connaissez le prix d'abord

Chaque tâche coûte des crédits (1 crédit = 0,01 $). Demandez un devis avant de créer : c'est gratuit, sans Idempotency-Key, et cela renvoie exactement ce que la tâche réservera. Le même nombre revient comme credits_reserved quand vous créez la tâche, et credits_charged sur la tâche terminée est ce que vous avez réellement payé (toute réservation inutilisée est rendue).

GET /v1/credits affiche à tout moment votre solde disponible et réservé. Les tâches créées via l'API apparaissent aussi dans le studio, sous Mes créations et dans l'historique des Crédits.

Endpoints

• GET /v1/models — Les modèles, avec durées, résolutions, formats, prix en crédits par seconde et limites de références.
• POST /v1/videos/quote — Coût exact en crédits d'une tâche. Gratuit, sans réservation.
• POST /v1/videos — Créer une tâche. Corps : kind (t2v | i2v | r2v), model, prompt, duration_s, resolution, ratio, generate_audio facultatif, references. Exige Idempotency-Key.
• GET /v1/videos/{id} — Statut de la tâche ; une tâche succeeded porte video_url.
• GET /v1/videos — Vos tâches, de la plus récente à la plus ancienne, paginées par curseur (limit, cursor).
• POST /v1/videos/{id}/cancel — Annuler une tâche waiting ou queued.
• POST /v1/files/presign — Emplacement de téléversement pour une image, une vidéo ou un fichier audio de référence.
• POST /v1/files/{media_id}/confirm — Finaliser un téléversement : le fichier est analysé et contrôlé, puis utilisable comme référence.
• GET /v1/credits — Crédits disponibles et réservés.

Limites

• 60 requêtes par minute et par clé.
• 2 tâches en cours (waiting, queued ou running) par compte via l'API.
• Les voies par modèle sont partagées par tous ; quand une voie est pleine, votre tâche attend son tour et est envoyée automatiquement.
• Jusqu'à 5 clés actives par compte.
• Fichiers : images jusqu'à 10 Mo, vidéo jusqu'à 50 Mo, audio jusqu'à 20 Mo. Les vidéos de référence doivent durer au moins 2 secondes ; vidéo et audio peuvent durer au plus 5 minutes.