Passer au contenu principal
POST
/
v3
/
async
/
vidu-q2-pro-fast-startend2video
VIDU Q2 Pro Fast images de début et de fin
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-pro-fast-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 une vidéo cohérente à partir de deux images, l’une de début et l’autre de fin (mode rapide). Prend en charge deux résolutions : 720p et 1080p. Le mode rapide peut réduire considérablement le temps de génération et convient aux scénarios exigeant une vitesse élevée.
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 d’énumération : 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électionnera automatiquement une musique appropriée dans la bibliothèque BGM prédéfinie et l’ajoutera ; false : aucune BGM ne sera ajoutée. La durée de la BGM n’est pas limitée ; le système l’adapte automatiquement à la durée de la vidéo.
​
seed
integer
Graine aléatoire. Lorsqu’elle n’est pas fournie par défaut ou qu’elle vaut 0, un nombre aléatoire sera utilisé à la place ; si elle est définie manuellement, la graine définie sera 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. Deux images en entrée sont prises en charge. 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 : il est possible de fournir une image encodée en Base64 ou une URL d’image (assurez-vous qu’elle est accessible). 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 la 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 des prompts recommandés. 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 de la vidéo à générer. Remarque 1 : la longueur ne doit pas dépasser 2000 caractères. Remarque 2 : si le paramètre de prompt recommandé is_rec est utilisé, le modèle ne tiendra pas compte du prompt saisi dans ce paramètre.Limite de longueur : 0 - 2000
​
wm_url
string
Contenu du filigrane, ici une URL d’image. Si ce paramètre n’est pas fourni, le filigrane par défaut est utilisé : contenu généré par l’IA.
​
payload
string
Paramètre transmis tel quel, sans aucun traitement, uniquement pour le transfert de données. Jusqu’à 1048576 caractères.Limite de longueur : 0 - 1048576
​
duration
integer
défaut:5
Durée de la vidéo (secondes), prend en charge 1 à 8 secondesValeurs 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 : en mode heures creuses, les tâches soumises qui n’ont pas pu être terminées seront automatiquement annulées et les crédits 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 définir un format personnalisé 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 récupérer 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. Prend en charge 720p et 1080p. La valeur par défaut est 720p.Valeurs possibles : 720p, 1080p
​
wm_position
integer
défaut:3
Position du filigrane, indique l’emplacement où le filigrane apparaît sur 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
Provider request ID (optional)