Guide JSON vers vidéo

Quand l'utiliser

Utilisez un workflow JSON vers vidéo lorsque :

• la sortie vidéo est dérivée de données structurées
• vous avez besoin de plusieurs variantes à partir de la même logique de template
• un produit, un agent ou un système d'automatisation doit déclencher la création vidéo
• vous voulez des aperçus avant la sortie finale
• vous avez besoin de tâches de rendu asynchrones et de callbacks de livraison

Si le workflow consiste surtout à ce qu'une personne édite une vidéo à la fois, un éditeur manuel peut être plus simple. Si le workflow exige de la répétabilité et une intégration logicielle, JSON constitue généralement une meilleure surface de contrôle.

Workflow recommandé

1. Générer ou assembler le schéma vidéo
2. Valider la structure du schéma et les références d'assets
3. Créer un aperçu
4. Relire ou affiner le schéma
5. Lancer la tâche de rendu finale
6. Interroger l'état de la tâche ou recevoir un webhook
7. Stocker ou livrer l'asset final

Checklist d'implémentation

• Définir la forme du schéma vidéo que votre produit générera
• Décider comment les assets sont téléversés ou référencés
• Valider les champs requis avant le rendu
• Générer des aperçus pour la revue par l'utilisateur ou le système
• Stocker les identifiants de tâche et les transitions d'état
• Gérer les rendus échoués et les nouvelles tentatives
• Livrer les assets finaux via polling ou webhooks
• Garder les templates réutilisables séparés des données d'exécution

Surface minimale du schéma

Un schéma de production a généralement besoin de :

• meta pour les réglages du canvas et les métadonnées vidéo
• assets pour les images, vidéos, audios et polices
• tracks pour la structure de la timeline
• clips pour le texte, les médias, les formes, les sous-titres et les layouts
• des règles de timing et d'animation
• des informations sur la sortie et le cycle de vie des tâches

Pour les règles exactes au niveau des champs, consultez la référence Structure JSON et règles des champs.

Aperçu, rendu et livraison

• Aperçu : générer une version rapide pour vérifier la mise en page et les textes
• Rendu : créer l'asset de sortie final
• Livraison : exposer le résultat via polling, recherche de tâche ou webhook

Pour les détails spécifiques à l'API, poursuivez avec API et utilisation.

Documents liés

• Détails du schéma : Structure JSON et règles des champs
• Flux d'exécution : API et utilisation
• Payloads prêts à copier : Exemples
• Guides pratiques pas à pas : Tutoriels