Passer au contenu principal
POST
/
v3
/
async
/
vidu-q2-turbo-startend2video
VIDU Q2 Turbo images de début et de fin
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-turbo-startend2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "bgm": true,
  "seed": 123,
  "images": [
    {}
  ],
  "is_rec": true,
  "prompt": "<string>",
  "wm_url": "<string>",
  "payload": "<string>",
  "duration": 123,
  "off_peak": true,
  "meta_data": "<string>",
  "watermark": true,
  "resolution": "<string>",
  "wm_position": 123,
  "movement_amplitude": "<string>"
}
'
{
  "task_id": "<string>",
  "provider_request_id": "<string>"
}
Générez rapidement une vidéo cohérente à partir de deux images, une image de début et une image de fin. Prend en charge trois résolutions : 540p, 720p et 1080p. La version Turbo offre un équilibre entre vitesse de génération et qualité vidéo.
Il s’agit d’une API asynchrone qui renvoie uniquement le task_id de la tâche asynchrone. Vous devez utiliser ce task_id pour appeler l’API de consultation du résultat de tâche afin de récupérer le résultat généré.

​
En-têtes de requête

​
Content-Type
string
requis
Valeur énumérée : application/json
​
Authorization
string
requis
Format d’authentification Bearer : Bearer {{API Key}}.

​
Corps de la requête

​
bgm
boolean
défaut:false
Indique s’il faut ajouter une musique de fond à la vidéo générée. true : le système sélectionne automatiquement une musique adaptée dans la bibliothèque BGM prédéfinie et l’ajoute ; false : aucun BGM n’est ajouté. La durée du BGM n’est pas limitée ; le système l’adapte automatiquement à la durée de la vidéo.
​
seed
integer
Graine aléatoire. Lorsque ce paramètre n’est pas transmis par défaut ou qu’il vaut 0, un nombre aléatoire est utilisé à la place ; si vous le définissez manuellement, la graine définie est utilisée.
​
images
array
requis
Tableau d’images : la première image est considérée comme l’image de début, la seconde comme l’image de fin. Le modèle générera la vidéo à partir des images transmises dans ce paramètre. Prend en charge l’entrée de deux images. Remarque 1 : les résolutions des deux images d’entrée de début et de fin doivent être proches ; le rapport résolution de l’image de début/résolution de l’image de fin doit être compris entre 0.8 et 1.25 ; remarque 2 : prend en charge les images encodées en Base64 ou les URL d’images (assurez-vous qu’elles sont accessibles) ; remarque 3 : les formats d’image pris en charge sont png, jpeg, jpg et webp ; remarque 4 : la taille de l’image ne doit pas dépasser 50M ; remarque 5 : l’encodage Base64 doit inclure une chaîne de type de contenu appropriée, par exemple : data:image/png;base64,Longueur du tableau : 2 - 2
​
is_rec
boolean
défaut:false
Indique s’il faut utiliser un prompt recommandé. true : oui, le système recommande automatiquement un prompt et utilise son contenu pour générer la vidéo (chaque tâche consomme 10 crédits supplémentaires) ; false : non, la vidéo est générée selon le prompt saisi
​
prompt
string
Prompt textuel, description textuelle pour générer la vidéo. Remarque 1 : la longueur ne doit pas dépasser 2000 caractères ; remarque 2 : si le paramètre is_rec de prompt recommandé est utilisé, le modèle ne tiendra pas compte du prompt saisi dans ce paramètreLimite de longueur : 0 - 2000
​
wm_url
string
Contenu du filigrane, ici sous forme d’URL d’image. S’il n’est pas transmis, le filigrane par défaut est utilisé : contenu généré par l’IA
​
payload
string
Paramètres transmis tels quels, sans aucun traitement, uniquement pour le transfert de données. 1048576 caractères au maximum.Limite de longueur : 0 - 1048576
​
duration
integer
défaut:5
Durée de la vidéo (en secondes), de 1 à 8 secondes prises en chargeValeurs possibles : 1, 2, 3, 4, 5, 6, 7, 8
​
off_peak
boolean
défaut:false
Mode heures creuses. true : générer la vidéo en heures creuses (consommation de crédits plus faible, génération sous 48 heures) ; false : générer la vidéo immédiatement. Remarque : les tâches soumises en mode heures creuses qui ne peuvent pas être terminées seront automatiquement annulées et les crédits seront remboursés ; vous pouvez également annuler manuellement les tâches en heures creuses.
​
meta_data
string
Identifiant de métadonnées, chaîne au format json, champ transmis tel quel. Vous pouvez personnaliser le format ou utiliser le format d’exemple. Lorsque ce paramètre est vide, l’identifiant de métadonnées généré par vidu est utilisé par défaut.
​
watermark
boolean
défaut:false
Indique s’il faut ajouter un filigrane. Par défaut, aucun filigrane n’est ajouté. Vous pouvez obtenir le contenu vidéo avec filigrane via le paramètre watermarked_url.
​
resolution
string
défaut:"720p"
Résolution de la vidéo de sortie. La valeur par défaut est 720p.Valeurs possibles : 540p, 720p, 1080p
​
wm_position
integer
défaut:3
Position du filigrane, indiquant l’emplacement du filigrane dans l’image. 1 : coin supérieur gauche ; 2 : coin supérieur droit ; 3 : coin inférieur droit (par défaut) ; 4 : coin inférieur gaucheValeurs possibles : 1, 2, 3, 4
​
movement_amplitude
string
défaut:"auto"
Amplitude du mouvement, contrôle l’intensité du mouvement des objets dans la vidéoValeurs possibles : auto, small, medium, large

​
Informations de réponse

​
task_id
string
requis
Utilisez le task_id pour appeler l’API de consultation du résultat de tâche afin de récupérer la sortie générée.
​
provider_request_id
string
ID de requête du fournisseur (facultatif)