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 img_uuid renvoyé ou recevez des callbacks de statut.
Obtenir une clé API
Scène cinématographique au bord d'un lac illustrant la cohérence entre référence et vidéo

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.
Maquettes de personnages sans marque présentées ensemble pour référence visuelle

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.
Plateforme de caméra cinématographique représentant un flux de production asynchrone
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 model sur viduq3_reference et fournissez le prompt textuel requis décrivant la vidéo souhaitée.

Images de référence

Envoyez 1 à 7 URL dans image_urls. 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 image_urls, et non image_url ou image_end_url. Utilisez viduq3_pro 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 540p, 720p ou 1080p. La valeur par défaut documentée est 720p.

Format de sortie

Définissez ratio sur 16:9, 9:16 ou 1:1 ; la valeur par défaut documentée est 16:9. aspect_ratio 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.
Obtenir une clé API
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.

FAQ de l'API Vidu Q3 Reference

Quel est le point de terminaison de l'API Vidu Q3 Reference sur GoEnhance ?

Soumettez une requête POST https://api.goenhance.ai/api/v1/videos/generations avec model défini sur viduq3_reference. Une soumission réussie renvoie un img_uuid pour un suivi asynchrone.

Comment fonctionne la tarification de l'API Vidu Q3 Reference ?

La tarification est par seconde générée : 1,75 jetons/s ($0.035/s) en 540p, 3 jetons/s ($0.06/s) en 720p et 3,75 jetons/s ($0.075/s) en 1080p. Multipliez le tarif sélectionné par la durée.

Combien d'images de référence puis-je envoyer ?

Le tableau image_urls documenté nécessite 1 à 7 images. Chacune doit respecter les limites publiées de format, de taille, de dimension et de ratio d'aspect.

Puis-je envoyer image_url ou image_end_url ?

Non. Cette route de référence dédiée accepte image_urls. Utilisez la route viduq3_pro documentée séparément pour la génération texte-vers-vidéo, image-vers-vidéo à partir de la première image, ou génération image de début-fin.

Quelles valeurs de durée, de résolution et de ratio sont prises en charge ?

La durée est de 3 à 16 secondes. La résolution prend en charge le 540p, le 720p et le 1080p. Le format prend en charge le 16:9, le 9:16 et le 1:1.

Comment savoir quand la vidéo est terminée ?

Conservez le img_uuid et interrogez GET /api/v1/jobs/detail, ou fournissez une custom_callback_url HTTPS publique. Les réponses de rappel autres que 200 sont réessayées jusqu'à trois fois avec un délai d'attente de trois secondes par tentative.

S'agit-il de l'API officielle de ShengShu ?

Non. Vidu est développé par ShengShu Technology. Cette page décrit l'accès indépendant à l'API par des tiers via GoEnhance et n'implique aucune affiliation, partenariat ou approbation.

En quoi Vidu Q3 Reference diffère-t-il du niveau de référence Turbo ?

Cette page couvre la route standard viduq3_reference. La route viduq3_turbo_reference, documentée séparément, est le niveau de référence plus rapide et moins cher ; ne mélangez pas son identifiant de modèle ou sa tarification dans cette requête.

Commencez à développer avec l'API Vidu Q3 Reference