img_uuid renvoyé, puis interrogez le système ou utilisez un rappel pour recevoir la vidéo générée.API Vidu Q3 Turbo Reference pour des sujets vidéo cohérents
Accédez à l'API Vidu Q3 Turbo Reference via l'API ouverte et indépendante de GoEnhance. Envoyez 1 à 7 images de référence avec un prompt, conservez l'
Obtenir une clé API
Créer une requête valide de référence vers vidéo
Fournir 1 à 7 images de référence
Effectuez une requête POST vers https://api.goenhance.ai/api/v1/videos/generations avec model: viduq3_turbo_reference, un prompt obligatoire et un tableau image_urls contenant 1 à 7 URL d'images publiques.
Suivre chaque tâche asynchrone
Choisissez une durée de 1 à 16 secondes et une résolution de 540p, 720p ou 1080p. Enregistrez l'img_uuid renvoyé, puis interrogez GET /api/v1/jobs/detail ou configurez custom_callback_url.
Validez le contrat réservé aux références avant de soumettre une tâche de production.
Capacités et paramètres de l'API Vidu Q3 Turbo Reference
ID de modèle exact
Définissez <code>model</code> sur <code>viduq3_turbo_reference</code> ; conservez le trait de soulignement exactement tel quel.
Prompt requis
Décrivez l'action prévue, le décor, le comportement de la caméra et le traitement visuel dans le <code>prompt</code>.
Tableau de références
Fournissez 1 à 7 URL d'images publiques via <code>image_urls</code>.
Route réservée aux références
N'envoyez pas <code>image_url</code> ou <code>image_end_url</code> ; utilisez <code>viduq3_turbo</code> pour ces modes.
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
Utilisez <code>540p</code>, <code>720p</code> ou <code>1080p</code> ; la valeur par défaut documentée est <code>720p</code>.
Estimez le coût total en multipliant le tarif par seconde sélectionné par la durée demandée.
Tarification de l'API Vidu Q3 Turbo Reference
540p
1 jeton par seconde générée, soit $0.02 par seconde au tarif documenté de $0.02 par jeton.
720p
2,5 jetons par seconde générée, soit $0.05 par seconde au tarif documenté de $0.02 par jeton.
1080p
3,25 jetons par seconde générée, soit $0.065 par seconde au tarif documenté de $0.02 par jeton.
Intégrer l'API Vidu Q3 Turbo 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 approuvées sur des URL publiques que votre requête peut fournir dans
image_urls. 3
3. Valider la charge utile
Définissez l'ID de modèle exact, l'invite, la durée et une résolution documentée ; omettez les champs réservés à la première image uniquement.
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 fournissez une URL de rappel HTTPS publique. 6
6. Gérer l'achèvement
Traitez le succès ou l'échec final de manière idempotente et vérifiez la vidéo renvoyée avant toute utilisation en aval.
Construisez des pipelines reproductibles où des entrées visuelles approuvées guident une scène générée.
Cas d'utilisation pour les développeurs pour la vidéo basée sur des références
Continuité des personnages
Utilisez plusieurs vues de personnages approuvées pour guider les sujets récurrents à travers de courts clips générés.
Storytelling produit
Fournissez des références de produits et une invite de scène pour des concepts de campagne révisables.
Variantes de campagne
Réutilisez un ensemble de références visuelles approuvées tout en modifiant les invites pour différents placements ou temps forts du récit.
Prévisualisation
Transformez les références de personnages, d'accessoires et d'environnements en concepts de mouvement avant la production complète.
Créations localisées
Paramétrez les invites de scène tout en conservant les mêmes références visuelles approuvées à travers les variantes régionales.
Contenu sérialisé
Guidez les sujets récurrents et la direction artistique à travers des tâches asynchrones soumises indépendamment.
Réponses aux questions courantes sur les entrées, la tarification, le statut des tâches et l'API ShengShu.