API de référence Seedance 2.0 : vidéo multi-modale programmatique

L'accès programmatique aux vidéos IA multi-modales change ce qui est possible. Les clips ponctuels sont excellents 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 par lot - nécessitent un accès API.

L'API de référence Seedance 2.0 expose toute la capacité multi-modale : jusqu'à 9 images, 3 vidéos et 3 clips audio par requête, programmatiquement, au même tarif par seconde que l'interface web.

Quand utiliser l'API

L'interface web est excellente pour les travaux créatifs manuels, un à la fois. L'API est pour tout le reste.

L'API convient quand vous avez besoin de :

• Génération par lot sur des centaines d'actifs
• Intégration avec des pipelines de contenu ou de produits existants
• Vidéo personnalisée par utilisateur dans une application
• Test A/B automatisé des variantes créatives publicitaires
• Génération de contenu planifiée pour la publication quotidienne
• Workflows de catalogage liés à des enregistrements de base de données

Restez avec l'interface web quand :

• Vous itérez de manière créative et devez voir/ajuster chaque sortie
• Le volume est faible (moins de 10-20 clips par session)
• Vous explorez l'outil pour la première fois

Le point d'accès

Le point d'accès de référence à vidéo est :

bytedance/seedance-2.0/reference-to-video

C'est le seul point d'accès dont vous avez besoin pour les générations en mode Référence multi-modale. Une seule requête gère le 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-à-vidéo ou image unique, utilisez plutôt les points d'accès API standard Seedance 2.0.

Structure de la requête

Une requête typique de référence à vidéo comprend :

• prompt : Description textuelle du sujet et de l'action (obligatoire)
• reference_images : Tableau d'jusqu'à 9 URLs d'images ou références de fichiers
• reference_videos : Tableau d'jusqu'à 3 URLs vidéo (facultatif)
• reference_audio : Tableau d'jusqu'à 3 URLs audio (facultatif)
• duration : Durée de sortie en secondes, 4-15 (obligatoire)
• aspect_ratio : Un de 16:9, 9:16, 1:1 (obligatoire)

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

Tarification via l'API

La tarification de l'API correspond exactement à celle de l'interface web :

Il n'y a pas de frais d'accès API et aucun frais supplémentaire pour les uploads de référence. Vous payez uniquement pour les secondes de sortie générées.

Les crédits fonctionnent de la même manière sur l'API et l'interface web. Rechargez via page de tarification et le même pool de crédits est utilisé par les deux interfaces. Pour une utilisation API à haut volume, le tier Max 100 $ (12 000 crédits) est le point de départ le plus économique.

Commencez à construire avec l'API. Obtenez l'accès à l'API avec 50 crédits gratuits à l'inscription. Commencer gratuitement.

Exemples de cas d'usage

Automatisation des vidéos de catalogue

Pour les plateformes de commerce électronique avec des centaines ou des milliers de SKU, l'API vous permet de générer une courte vidéo de produit pour chaque produit en fonction des images de produit existantes.

Workflow :

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

Économies : Catalogue de 500 SKU à 5 secondes de vidéo = 500 × 303 crédits = 151 500 crédits = environ 1 515 $. Pour un lancement vidéo à l'échelle du catalogue, c'est une valeur remarquable.

Génération de vidéo personnalisée

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

Workflow :

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

Cela s'adapte à des dizaines de milliers d'utilisateurs sans frais généraux d'équipe de contenu.

Génération de variante créative publicitaire

Les équipes marketing exécutant des campagnes sociales payantes ont besoin de constantes variantes créatives. L'API vous permet de générer des variantes de test A/B programmatiquement.

Workflow :

1. Définissez un paquet de référence de marque (6-8 images)
2. Écrivez des modèles d'invite pour différents angles publicitaires
3. Parcourez les variantes, en appelant l'API pour chacune
4. Livrez les clips générés à votre plateforme publicitaire
5. Suivez la performance et générez les gagnants à grande échelle

Vous pouvez produire 50 variantes publicitaires en une exécution automatisée pour environ 150 $ de coûts API, par rapport à la production traditionnelle à des milliers par variante.

Gestion des réponses

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

• ID de génération : Suivez l'état de la requête
• Statut : en attente, traitement, complet, échoué
• URL de sortie : Disponible une fois que le statut est complet
• Métadonnées : Durée, résolution, taille du fichier

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

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

Limites de débit et concurrence

Pour la plupart des tiers de compte, des limites de génération concurrente s'appliquent. Planifiez vos workflows par lot pour respecter les limites - mettez en file d'attente les requêtes et traitez-les à la concurrence autorisée.

Pour les workflows de production à haut volume, contactez le support de plateforme à propos des limites de concurrence entreprise. La plupart des comptes standard peuvent gérer le travail par lot modéré (10-30 générations concurrentes) sans problème.

Authentification et clés

L'accès API utilise l'authentification standard basée sur les clés. Générez votre clé API dans les paramètres de votre compte après vous être inscrit. Gardez les clés du côté serveur uniquement - ne les exposez jamais dans le code client.

Idempotence et retries

Les générations API ne sont pas nativement idempotentes car chaque appel coûte des crédits. Si une génération échoue à mi-processus, la logique de retry doit vérifier l'état de la génération échouée avant de re-demander. Une génération échouée ne consomme généralement pas de crédits, mais vérifiez toujours dans votre tableau de bord de compte.

Pour les workflows de production, implémentez :

• Logique de retry avec backoff exponentiel sur les défaillances transitoires
• Interrogation de statut ou gestion de webhook pour l'achèvement asynchrone
• Enregistrement d'erreurs pour attraper les problèmes systématiques
• Surveillance du solde de crédit pour alerter avant d'épuiser

Meilleures pratiques pour les workflows programmatiques

1. Utilisez des paquets de référence cohérents. Pour le travail de catalogue ou de série, hash vos paquets de référence afin que des paquets identiques sur les requêtes produisent un style plus cohérent.

2. Gardez les modèles d'invite simples. Les invites programmatiques doivent être générées à partir de données structurées, pas écrites à la main par appel. Le modèle + les champs de données est le bon motif.

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

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

5. Enregistrez les métadonnées de génération. Suivez chaque génération - invite, ensemble de référence, durée, crédits consommés, URL de sortie - dans la base de données de votre application. Cela rend le débogage et la création de rapports beaucoup plus faciles.

Exemple de workflow par lot

Pseudocode pour un workflow de génération de vidéo de produit par lot :

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 l'achèvement et stocke l'URL de sortie par rapport à l'enregistrement de produit.

Surveillance et contrôle des coûts

Pour l'utilisation de l'API de production, configurez la surveillance des coûts :

• Alertes budgétaires quotidiennes : Alertez quand la dépense API quotidienne dépasse un seuil
• Plafonds par workflow : Limitez les travaux par lot à une dépense de crédit maximale pour éviter l'automatisation incontrôlée
• Tableaux de bord d'utilisation : Suivez les workflows qui consomment le plus de crédits
• Alertes de solde de crédit : Rechargez avant d'épuiser

Ces garde-fous préviennent les surprises quand vous mettez à l'échelle l'automatisation.

Parité de tarification API vs interface web

Une question courante : y a-t-il une remise pour l'utilisation de l'API ? Non - l'API et l'interface web facturent toutes les deux 0,3024 $ par seconde. L'API est tarifée selon le travail qu'elle fait, pas selon l'interface que vous utilisez.

Où les utilisateurs à haut volume économisent est dans la sélection de leur tier. Les utilisateurs API à haut volume doivent exécuter sur Palier Max $100 pour la meilleure valeur par dollar.

Premiers pas avec l'API

1. Inscrivez-vous à arteza.ai (50 crédits gratuits)
2. Générez votre clé API dans les paramètres de compte
3. Rechargez un paquet de crédits correspondant à votre volume attendu
4. Intégrez le point d'accès dans votre application
5. Commencez avec de petits lots de test pour valider votre workflow
6. Mettez à l'échelle vers la production une fois testé

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

Lectures suivantes

Pour l'ensemble complet des fonctionnalités Reference, lisez Guide complet Seedance 2.0 Reference. Pour le workflow de l'interface web, consultez tutoriel style-consistent. Pour les détails API standard Seedance 2.0, vérifiez Guide API Seedance 2.0.

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