img_uuid renvoyé, puis effectuez un polling ou recevez des callbacks jusqu'à ce que la tâche réussisse ou échoue.API Vidu Q3 Pro pour la génération vidéo
Accédez à Vidu Q3 Pro via l'API ouverte et indépendante de GoEnhance pour la génération de texte vers vidéo, d'image vers vidéo et de début-fin de séquence. Soumettez une requête asynchrone, conservez l'
Obtenir une clé API
Construire une requête API Vidu Q3 Pro claire
Trois modes d'entrée sur un seul point de terminaison
Envoyez une requête POST vers https://api.goenhance.ai/api/v1/videos/generations avec model: viduq3_pro. Utilisez uniquement un prompt pour le texte vers vidéo, ajoutez image_url pour une première image, ou ajoutez image_end_url pour une génération avec image de début et de fin.
Contrôles explicites et exécution asynchrone
Validez la durée, la résolution et le ratio texte vers vidéo avant la soumission. Enregistrez l'ID de tâche renvoyé, puis utilisez GET /api/v1/jobs/detail ou une custom_callback_url HTTPS publique pour gérer les résultats finaux.
Faites correspondre le schéma de requête documenté avant qu'une tâche n'entre dans votre pipeline vidéo.
Capacités et paramètres de l'API Vidu Q3 Pro
Modèle
Définissez <code>model</code> sur <code>viduq3_pro</code>.
Prompt
Fournissez le prompt textuel requis décrivant la vidéo souhaitée.
Première image
Ajoutez une <code>image_url</code> publique pour la génération d'image vers vidéo ; omettez-la pour le texte vers vidéo.
Dernière image
Ajoutez <code>image_end_url</code> avec <code>image_url</code> pour un contrôle de début et de fin de séquence.
Durée
Choisissez un nombre entier compris entre 1 et 16 secondes. La valeur par défaut documentée est de 5 secondes.
Résolution et ratio
La résolution accepte 540p, 720p ou 1080p, avec 720p par défaut. Le champ <code>ratio</code> s'applique aux requêtes texte vers vidéo.
Estimez le coût de génération en multipliant le tarif par seconde sélectionné par la durée demandée.
Tarification de l'API Vidu Q3 Pro
540p
2,25 jetons par seconde générée, soit $0.045 par seconde au tarif documenté de $0.02 par jeton.
720p
5 jetons par seconde générée, soit $0.10 par seconde au tarif documenté de $0.02 par jeton.
1080p
6 jetons par seconde générée, soit $0.12 par seconde au tarif documenté de $0.02 par jeton.
Intégrer Vidu Q3 Pro en six étapes
1
1. Créer une clé API
Créez une clé GoEnhance et envoyez-la en tant que jeton bearer dans l'en-tête Authorization.
2
2. Sélectionner le mode d'entrée
Utilisez uniquement un prompt, ajoutez une URL de première image, ou ajoutez à la fois les URL de première et de dernière image.
3
3. Valider la requête
Définissez
viduq3_pro, une durée de 1 à 16 secondes, et l'une des valeurs de résolution documentées. 4
4. Soumettre la tâche vidéo
Envoyez une requête POST vers
/api/v1/videos/generations et conservez l'img_uuid renvoyé. 5
5. Suivre le statut
Interrogez
GET /api/v1/jobs/detail ou configurez une URL de rappel HTTPS publique. 6
6. Gérer l'achèvement
Traitez les états de succès et d'échec de manière idempotente, et vérifiez l'actif renvoyé avant toute utilisation ultérieure.
Construisez des flux de travail de génération vidéo répétables autour d'entrées explicites et d'états de tâche terminaux.
Cas d'utilisation développeur pour l'API Vidu Q3 Pro
Variantes de vidéos de campagne
Générez de courts clips conceptuels à partir de prompts structurés pour la révision créative et l'assemblage ultérieur.
Mouvement de produit
Animez une image de produit approuvée pendant que votre application contrôle les prompts, la validation et la révision des actifs.
Transitions de storyboard
Utilisez les entrées de première et dernière image pour explorer le mouvement entre deux temps forts visuels approuvés.
Pipelines créatifs localisés
Paramétrez les prompts pour les variantes de campagnes régionales sans modifier le gestionnaire de tâches asynchrone.
Production de vidéos pour les réseaux sociaux
Créez de courts actifs animés à une résolution et une durée sélectionnées par votre application.
Prévisualisation
Transformez des descriptions de plans concises en concepts animés révisables avant la production complète.
Réponses aux questions fréquentes sur la tarification, les entrées, le statut des tâches et l'API vidéo ShengShu.