Seedance 2.0 Reference API : vidéo multimodale par programmation

L'accès programmatique à la vidéo IA multi-modale change ce qui est possible. Les clips ponctuels sont parfaits pour le marketing et la création de contenu, mais les workflows automatisés - génération de vidéos de catalogue, personnalisation par utilisateur, opérations de contenu en masse - nécessitent un accès API.

L'API Reference de Seedance 2.0 expose la pleine capacité multi-modale : jusqu'à 9 images, 3 vidéos et 3 clips audio par requête, de manière programmatique, au même tarif à la seconde que l'interface web.

En résumé

• Endpoint : bytedance/seedance-2.0/reference-to-video
• Entrées : invite texte + jusqu'à 9 images + 3 vidéos + 3 clips audio
• Tarif : 0,3024 dollar/sec de sortie, identique à l'interface web
• Sortie : vidéo 720p, 4-15 secondes, synchronisation audio native
• Temps de génération : 60-180 secondes par requête
• Idéal pour l'automatisation de catalogues, les workflows en masse et le contenu programmatique
• Essayez l'API gratuitement avec 10 crédits

Quand utiliser l'API

L'interface web est idéale pour un travail créatif manuel, clip par clip. L'API est faite pour tout le reste.

L'API convient quand vous avez besoin de :

• Générer en masse sur des centaines d'assets
• S'intégrer à des pipelines de contenu ou de produits existants
• Produire des vidéos personnalisées par utilisateur dans une application
• Automatiser les tests A/B de variantes de créations publicitaires
• Planifier la génération de contenu pour une publication quotidienne
• Gérer des workflows de catalogage liés à des enregistrements de base de données

Restez sur l'interface web quand :

• Vous itérez de façon créative et avez besoin de voir et d'ajuster chaque résultat
• Le volume est faible (moins de 10 à 20 clips par session)
• Vous découvrez l'outil pour la première fois

L'endpoint

L'endpoint Reference-to-video est :

bytedance/seedance-2.0/reference-to-video

C'est le seul endpoint dont vous avez besoin pour les générations en mode Reference multi-modal. Une seule requête gère du texte, jusqu'à 9 images, jusqu'à 3 vidéos et jusqu'à 3 clips audio. Le modèle fusionne toutes les entrées et retourne une vidéo générée.

Pour les workflows texte-vers-vidéo ou image unique, utilisez plutôt les endpoints API standard Seedance 2.0.

Structure de la requête

Une requête Reference-to-video typique comprend :

• prompt : Description textuelle du sujet et de l'action (obligatoire)
• reference_images : Tableau de jusqu'à 9 URL d'images ou références de fichiers
• reference_videos : Tableau de jusqu'à 3 URL de vidéos (optionnel)
• reference_audio : Tableau de jusqu'à 3 URL audio (optionnel)
• duration : Durée de sortie en secondes, de 4 à 15 (obligatoire)
• aspect_ratio : L'un des formats 16:9, 9:16, 1:1 (obligatoire)

Les fichiers d'entrée peuvent être fournis sous forme d'URL (accessibles publiquement) ou téléversés directement selon votre mode d'intégration.

Tarification via l'API

La tarification API est exactement la même que celle de l'interface web :

Il n'y a pas de frais d'accès à l'API ni de surcoût pour les téléversements de références. Vous ne payez que pour les secondes de sortie générées.

Les crédits fonctionnent de la même façon via l'API et l'interface web. Rechargez votre compte via page de tarification ; le même pool de crédits est utilisé par les deux interfaces. Pour une utilisation intensive de l'API, le plan Studio à 120 dollars (1 800 crédits par mois) offre le meilleur taux par crédit, et tout rechargement supplémentaire que vous ajoutez n'expire jamais.

Commencez à développer avec l'API. Obtenez un accès API avec 10 crédits offerts à l'inscription. Commencer gratuitement.

Exemples de cas d'usage

Automatisation de vidéos de catalogue

Pour les plateformes e-commerce comptant des centaines ou des milliers de références, l'API vous permet de générer une courte vidéo produit pour chaque article à partir des images produit existantes.

Workflow :

1. Interrogez votre base de données produits
2. Pour chaque produit, récupérez 5 à 7 images produit
3. Combinez-les avec un bundle de référence de marque (2 à 3 images)
4. Appelez l'API avec un template d'invite pour la révélation du produit
5. Stockez l'URL de la vidéo retournée dans votre fiche produit
6. Diffusez sur les pages de détail produit

Économie : Un catalogue de 500 références avec des vidéos de 5 secondes = 500 × 303 crédits = 151 500 crédits = environ 1 515 dollars. Pour un déploiement vidéo à l'échelle d'un catalogue entier, c'est une valeur remarquable.

Génération de vidéos personnalisées

Pour les applications qui produisent des vidéos personnalisées par utilisateur - cartes de vœux, contenus de célébration, introductions d'onboarding - l'API vous permet de générer des vidéos à la demande avec des références spécifiques à chaque utilisateur.

Workflow :

1. L'utilisateur téléverse 3 à 5 photos personnelles (avec consentement)
2. Votre application les combine avec un bundle de référence de style
3. Un appel API génère un clip vidéo personnalisé
4. Livrez-le à l'utilisateur via votre application

Cette approche passe à l'échelle de dizaines de milliers d'utilisateurs sans surcharge pour l'équipe contenu.

Génération de variantes de créations publicitaires

Les équipes marketing qui gèrent des campagnes sociales payantes ont constamment besoin de variantes créatives. L'API vous permet de générer des variantes de tests A/B de manière programmatique.

Workflow :

1. Définissez un bundle de référence de marque (6 à 8 images)
2. Rédigez des templates d'invites pour différents angles publicitaires
3. Parcourez les variantes en boucle, en appelant l'API pour chacune
4. Livrez les clips générés à votre plateforme publicitaire
5. Analysez les performances et générez les variantes gagnantes à grande échelle

Vous pouvez produire 50 variantes publicitaires dans un cycle automatisé pour environ 150 dollars de coûts API, contre une production traditionnelle à plusieurs milliers de dollars par variante.

Gestion des réponses

Les réponses API comprennent généralement :

• ID de génération : Suivi du statut de la requête
• Statut : pending, processing, complete, failed
• URL de sortie : Disponible une fois le statut passé à complete
• Métadonnées : Durée, résolution, taille du fichier

Les générations en mode Reference prennent 60-180 secondes, donc votre intégration doit gérer les réponses asynchrones. Interrogez l'endpoint de statut ou utilisez des webhooks (si disponibles dans votre compte) pour être notifié à la fin.

Ne bloquez pas les flux côté utilisateur en attendant la fin de la génération. Mettez la requête en file d'attente, notifiez l'utilisateur quand elle est prête et livrez de manière asynchrone.

Limites de débit et concurrence

Pour la plupart des niveaux de compte, des limites de génération simultanée s'appliquent. Planifiez vos workflows en masse en respectant ces limites : mettez les requêtes en file d'attente et traitez-les à la concurrence autorisée.

Pour les workflows de production à fort volume, contactez le support de la plateforme concernant les limites de concurrence entreprise. La plupart des comptes standard peuvent gérer des travaux en masse modérés (10 à 30 générations simultanées) sans problème.

Authentification et clés

L'accès à l'API utilise une authentification standard par clé. Générez votre clé API dans les paramètres de votre compte après inscription. Conservez les clés côté serveur uniquement - ne les exposez jamais dans le code client.

Idempotence et nouvelles tentatives

Les générations API ne sont pas nativement idempotentes car chaque appel consomme des crédits. Si une génération échoue en cours de traitement, la logique de nouvelle tentative doit vérifier le statut de la génération échouée avant de relancer la requête. Une génération échouée ne consomme généralement pas de crédits, mais vérifiez toujours dans le tableau de bord de votre compte.

Pour les workflows de production, mettez en place :

• Une logique de nouvelle tentative avec backoff exponentiel en cas d'erreurs transitoires
• Une interrogation de statut ou la gestion de webhooks pour la complétion asynchrone
• Une journalisation des erreurs pour détecter les problèmes systématiques
• Une surveillance du solde de crédits pour être alerté avant d'en manquer

Bonnes pratiques pour les workflows programmatiques

1. Utilisez des bundles de références cohérents. Pour les travaux de catalogue ou de série, hachez vos bundles de références afin que des bundles identiques entre les requêtes produisent un style plus cohérent.

2. Gardez les templates d'invites simples. Les invites programmatiques doivent être générées à partir de données structurées, pas rédigées manuellement par appel. Le pattern template + champs de données est la bonne approche.

3. Mettez en cache les URL des fichiers de référence. Si vous utilisez des références basées sur des URL, assurez-vous que les URL sont stables et accessibles. Des URL S3 expirées ou des fichiers déplacés feront échouer les générations.

4. Gérez la sécurité du contenu de manière appropriée. La plateforme dispose de filtres de sécurité du contenu. Intégrez une gestion gracieuse des requêtes rejetées par les filtres dans votre workflow.

5. Journalisez les métadonnées de génération. Enregistrez chaque génération - invite, ensemble de références, durée, crédits consommés, URL de sortie - dans la base de données de votre application. Cela facilite grandement le débogage et le reporting.

Exemple de workflow en masse

Pseudo-code pour un workflow de génération de vidéos produit en masse :

for product in product_catalog:
    references = build_reference_bundle(
        brand_images,
        product.photo_urls[:4]
    )
    prompt = f"{product.name} product rotates slowly on a clean surface, soft studio lighting, 5 seconds"

    response = seedance_api.generate(
        endpoint="bytedance/seedance-2.0/reference-to-video",
        prompt=prompt,
        reference_images=references,
        duration=5,
        aspect_ratio="16:9"
    )

    generation_id = response.id
    queue_poll_task(generation_id, product.id)

Un poller de suivi gère la complétion et stocke l'URL de sortie dans la fiche produit.

Surveillance et contrôle des coûts

Pour une utilisation de l'API en production, mettez en place une surveillance des coûts :

• Alertes de budget quotidien : Alertez quand la dépense API journalière dépasse un seuil
• Plafonds par workflow : Limitez les tâches en masse à une dépense maximale en crédits pour éviter les automatisations incontrôlées
• Tableaux de bord d'utilisation : Suivez quels workflows consomment le plus de crédits
• Alertes de solde de crédits : Rechargez avant d'en manquer

Ces garde-fous évitent les mauvaises surprises lorsque vous montez en charge l'automatisation.

Parité tarifaire API et interface web

Une question fréquente : y a-t-il une réduction pour l'utilisation de l'API ? Non - l'API et l'interface web facturent toutes deux le même tarif de 0,3024 dollar par seconde. L'API est tarifée selon le travail effectué, pas selon l'interface utilisée.

Là où les utilisateurs à fort volume réalisent des économies, c'est dans le choix de leur niveau. Les utilisateurs intensifs de l'API devraient opter pour $120 Studio plan pour le meilleur rapport qualité-prix par dollar.

Premiers pas avec l'API

1. Inscrivez-vous sur arteza.ai (10 crédits offerts)
2. Générez votre clé API dans les paramètres du compte
3. Rechargez un pack de crédits correspondant à votre volume prévu
4. Intégrez l'endpoint dans votre application
5. Commencez par de petits lots de test pour valider votre workflow
6. Passez en production une fois les tests effectués

Le premier appel API peut être opérationnel en moins d'une heure après l'inscription pour la plupart des intégrations.

À lire ensuite

Pour l'ensemble complet des fonctionnalités Reference, consultez Guide complet de Seedance 2.0 Reference. Pour le workflow de l'interface web, voir tutoriel de cohérence de style. Pour les détails standard de l'API Seedance 2.0, consultez Guide de l'API Seedance 2.0.

La vidéo multi-modale programmatique est là. Créez quelque chose de nouveau avec elle.