img_uuid renvoyé ou recevez des callbacks de statut.API Vidu Q3 Reference pour une vidéo cohérente
Accédez à Vidu Q3 Reference via l'API ouverte et indépendante de GoEnhance. Fournissez 1 à 7 images de référence avec un prompt, soumettez une tâche vidéo asynchrone, puis effectuez un polling avec le
Obtenir une clé API
Construire une requête pour l'API Vidu Q3 Reference
Entrée d'image de référence conçue pour la cohérence
Effectuez une requête POST vers https://api.goenhance.ai/api/v1/videos/generations avec model: viduq3_reference, un prompt requis et image_urls contenant 1 à 7 images de référence publiques.
Requêtes validées et résultats asynchrones
Validez le format, les dimensions, le rapport hauteur/largeur, la durée, la résolution et le format de sortie de l'image avant la soumission. Conservez le img_uuid, puis effectuez un polling sur GET /api/v1/jobs/detail ou utilisez un callback HTTPS public.
Respectez le schéma de requête référence-vers-vidéo documenté avant de soumettre une tâche.
Capacités et limites de l'API Vidu Q3 Reference
Modèle et prompt
Définissez <code>model</code> sur <code>viduq3_reference</code> et fournissez le prompt textuel requis décrivant la vidéo souhaitée.
Images de référence
Envoyez 1 à 7 URL dans <code>image_urls</code>. Chaque image doit être au format PNG, JPEG, JPG ou WebP ; mesurer au moins 128×128 pixels ; ne pas dépasser 50 Mo ; et avoir un rapport hauteur/largeur compris entre 1:4 et 4:1.
Mode d'entrée dédié
Cette route accepte <code>image_urls</code>, et non <code>image_url</code> ou <code>image_end_url</code>. Utilisez <code>viduq3_pro</code> pour une génération basée uniquement sur du texte, une image initiale ou des images de début et de fin.
Durée
Choisissez un nombre entier compris entre 3 et 16 secondes. La valeur par défaut documentée est de 5 secondes.
Résolution
Sélectionnez <code>540p</code>, <code>720p</code> ou <code>1080p</code>. La valeur par défaut documentée est <code>720p</code>.
Format de sortie
Définissez <code>ratio</code> sur <code>16:9</code>, <code>9:16</code> ou <code>1:1</code> ; la valeur par défaut documentée est <code>16:9</code>. <code>aspect_ratio</code> est accepté comme alias compatible.
Estimez le coût en multipliant le tarif par seconde sélectionné par la durée demandée.
Tarification de l'API Vidu Q3 Reference
540p
1,75 jetons par seconde générée, soit $0.035 par seconde au tarif documenté de $0.02 par jeton.
720p
3 jetons par seconde générée, soit $0.06 par seconde au tarif documenté de $0.02 par jeton.
1080p
3,75 jetons par seconde générée, soit $0.075 par seconde au tarif documenté de $0.02 par jeton.
Intégrer Vidu Q3 Reference 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. Préparer les références
Hébergez 1 à 7 images de référence conformes sur des URL publiques et décidez quels détails visuels le prompt doit préserver.
3
3. Valider la requête
Définissez
viduq3_reference, une durée de 3 à 16 secondes, une résolution prise en charge et un ratio pris en charge. 4
4. Soumettre la tâche
Effectuez 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 custom_callback_url HTTPS publique. 6
6. Gérer l'achèvement
Traitez les états de succès et d'échec de manière idempotente, puis vérifiez l'actif généré avant toute utilisation en aval.
Construisez des flux de travail répétables de référence vers vidéo autour d'entrées explicites et d'états de tâche terminaux.
Cas d'utilisation développeur pour l'API Vidu Q3 Reference
Clips de campagne basés sur des personnages
Intégrez des personnages fictifs ou des références de talents approuvés dans des concepts de courtes vidéos de campagne.
Séquences d'identité de produit
Utilisez plusieurs vues de produits approuvées comme références visuelles pour une exploration créative axée sur le mouvement.
Continuité narrative
Référencez des sujets récurrents lors de la génération de plans distincts pour les flux de travail de storyboard et de prévisualisation.
Variantes créatives localisées
Réutilisez des références visuelles approuvées tout en adaptant les prompts pour des concepts de campagne régionaux.
Actifs sociaux cohérents en termes de style
Construisez des pipelines de vidéos courtes autour d'un ensemble contrôlé de références visuelles et de ratios de sortie.
Prototypage créatif
Testez des combinaisons de références, des prompts, des durées et des résolutions avant de vous engager dans un flux de production plus large.
Réponses aux questions courantes sur la tarification, les entrées de référence, les tâches asynchrones et l'API ShengShu.