Skip to main content
POST

Autorisation

string
requis
Tous les points de terminaison API nécessitent une authentification par Bearer TokenObtenir votre clé API :Rendez-vous sur la page de gestion des clés API pour obtenir votre clé APIAjoutez-la à l’en-tête de la requête :

Paramètres de la requête

string
requis
Nom du modèle de génération vidéoModèles pris en charge :
  • viduq3-pro — Vidu Q3 Pro
  • viduq3-turbo — Vidu Q3 Turbo
boolean
défaut:"false"
Indique s’il faut modérer le contenu avant d’envoyer la tâche vidéo.
  • true : vérifier les prompts et les images d’entrée avec omni-moderation-latest
  • false ou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)
string
requis
Prompt textuel, 2000 caractères maximumObligatoire pour le text-to-video. Optionnel pour l’image-to-video et le mode « première et dernière image ».Exemple : "A cat playing piano, camera slowly zooms in"
integer
défaut:"5"
Durée de la vidéo (en secondes)Plage : 1 à 16Par défaut : 5
string
défaut:"720p"
Résolution de la vidéoOptions :
  • 540p — définition standard
  • 720p — HD (par défaut)
  • 1080p — Full HD
Par défaut : 720p
string
Format d’image de la vidéo (uniquement en mode text-to-video)Options :
  • 16:9 — paysage
  • 9:16 — portrait
  • 4:3 — traditionnel
  • 3:4 — portrait traditionnel
  • 1:1 — carré
Ce paramètre n’est disponible qu’en mode text-to-video (lorsque image_urls n’est pas fourni).
array<url>
Tableau d’URL d’images pour la génération image-to-videoLe système détermine automatiquement le mode de génération en fonction du nombre d’images :
  • 0 image (non fourni) : mode text-to-video
  • 1 image : mode image-to-video (l’image est utilisée comme image de départ)
  • 2 images : mode « première et dernière image » (première image = image de début, seconde image = image de fin)
Exemple : ["https://example.com/photo.jpg"]
  • 2 images maximum prises en charge
  • Pour le mode « première et dernière image », exactement 2 images doivent être fournies
  • Lorsque image_urls est fourni (1 ou 2 images), le paramètre aspect_ratio ne peut pas être utilisé — le format d’image est automatiquement déterminé par l’image
boolean
défaut:"true"
Générer ou non l’audio (dialogues, effets sonores)Par défaut : trueDéfinissez sur false si vous avez besoin d’une vidéo silencieuse.
integer
Graine entière pour contrôler le caractère aléatoire du contenu généréPlage : entier entre -1 et 2^32-1
  • Pour la même requête, des valeurs de graine différentes (y compris non spécifiée ou -1, qui utilise un nombre aléatoire) produiront des résultats différents
  • Pour la même requête, la même valeur de graine produira des résultats similaires, mais une reproductibilité exacte n’est pas garantie

Routage automatique

Le système détermine automatiquement le mode de génération en fonction du nombre d’images dans image_urls :

Matrice de prise en charge des paramètres

Réponse

integer
Code de statut de la réponse, 200 en cas de succès
array
Tableau de données de la réponse

Cas d’usage

Cas 1 : Texte vers vidéo

Cas 2 : Image vers vidéo (image unique)

Cas 3 : Vidéo à partir de la première et de la dernière image

Cas 4 : Vidéo silencieuse (audio désactivé)

Interroger les résultats de la tâcheLa génération vidéo est une tâche asynchrone qui renvoie un task_id lors de la soumission. Utilisez le point de terminaison Obtenir le statut de la tâche pour interroger la progression et les résultats.