Passer au contenu principal
POST
/
v3
/
async
/
vidu-q2-pro-startend2video
VIDU Q2 Pro première et dernière image
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-pro-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, la première et la dernière. Prend en charge trois résolutions : 540p, 720p et 1080p.
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 requête 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électionne automatiquement une musique appropriée dans la bibliothèque BGM prédéfinie et l’ajoute ; false : n’ajoute pas de BGM. 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. Lorsque ce paramètre n’est pas fourni par défaut ou qu’il vaut 0, un nombre aléatoire sera utilisé à la place ; s’il est défini 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 initiale, la deuxième comme l’image finale, et le modèle générera la vidéo à partir des images fournies dans ce paramètre. Deux images sont prises en charge en entrée. Remarque 1 : les résolutions des deux images d’entrée initiale et finale doivent être proches ; le rapport résolution de l’image initiale / résolution de l’image finale doit être compris entre 0.8 et 1.25 ; remarque 2 : il est possible de fournir l’encodage Base64 de l’image ou l’URL de l’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 sous forme d’URL d’image. S’il 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 (en secondes), prend en charge 1 à 8 secondes.Valeurs possibles : 1, 2, 3, 4, 5, 6, 7, 8
​
off_peak
boolean
défaut:false
Mode heures creuses. true : génère la vidéo en heures creuses (consomme moins de crédits, génération sous 48 heures) ; false : génère la vidéo immédiatement. Remarque : les tâches soumises en mode heures creuses qui ne sont pas 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 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. La valeur par défaut est 720p.Valeurs possibles : 540p, 720p, 1080p
​
wm_position
integer
défaut:3
Position du filigrane, indique l’emplacement du filigrane 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éo.Valeurs possibles : auto, small, medium, large

​
Informations de réponse

​
task_id
string
requis
Utilisez le task_id pour appeler l’API de requête 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)