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-mix — qualité premium, transitions intelligentes renforcées, prend en charge les vidéos courtes de 1 seconde
  • viduq3 — choix par défaut, changement de plan plus intelligent
Comment choisir : utilisez viduq3 pour un usage quotidien ; utilisez viduq3-mix pour une qualité premium ou des effets de mouvement de 1 à 2 secondes.
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, 5000 caractères maximumDécrivez les actions et les mouvements de caméra, et non l’apparence (celle-ci est déterminée par les images de référence).Exemple : "Santa Claus and the bear hug by the lakeside"
array<url>
requis
Tableau d’URL d’images de référence, 1 à 7 imagesPrend en charge les URL d’images publiquement accessibles (http:// ou https://)Exemple : ["https://example.com/santa.png", "https://example.com/bear.png"]
  • Quantité : 1 à 7 images
  • Formats pris en charge : PNG, JPEG, JPG, WebP
  • Taille minimale : 128×128
  • Format d’image : entre 1:4 et 4:1
  • Taille maximale du fichier : ≤ 50 Mo par image
  • Doivent être des URL publiquement accessibles
integer
défaut:"5"
Durée de la vidéo (en secondes)
  • viduq3-mix : 1 à 16
  • viduq3 : 3 à 16
Par défaut : 5
viduq3 prend en charge un minimum de 3 secondes, viduq3-mix un minimum de 1 seconde. Veuillez fournir une durée valide selon le modèle choisi.
string
défaut:"720p"
Résolution de la vidéo
  • viduq3-mix : 720p (par défaut) / 1080p
  • viduq3 : 540p / 720p (par défaut) / 1080p
viduq3-mix ne prend pas en charge 540p, veuillez utiliser 720p ou 1080p.
string
défaut:"16:9"
Format d’image de la vidéoOptions :
  • 16:9 — paysage (par défaut)
  • 9:16 — portrait
  • 4:3 — traditionnel
  • 3:4 — portrait traditionnel
  • 1:1 — carré
integer
Graine aléatoire pour contrôler le caractère aléatoire de la générationSi elle n’est pas fournie, une graine aléatoire sera utilisée.
L’utilisation de la même graine avec des paramètres identiques produira des résultats similaires, sans garantie d’être exactement identiques.

Comparaison des modèles

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 : génération vidéo par référence de base avec viduq3

Cas 2 : génération vidéo par référence haute qualité avec viduq3-mix

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.