Créer une tâche image vers vidéo
- Documentation officielle : https://platform.vidu.cn/docs/image-to-video
- Crée une tâche image vers vidéo et renvoie task_id ou les détails de la tâche
- Contrôlez la génération via les paramètres de la requête
Authorizations
Request Body
Invite textuelle
Description textuelle pour la génération vidéo.
Remarque : 2000 caractères maximum
Nom du modèle
Valeurs autorisées : viduq2, viduq1, viduq3-turbo, viduq3-pro
- viduq3-turbo : génération plus rapide que viduq3-pro
- viduq3-pro : audio-vidéo de qualité, rendu plus vivant et expressif
- viduq2 : dernier modèle
- viduq1 : image nette, transitions fluides, mouvement de caméra stable
Durée de la vidéo ; par défaut selon le modèle :
- viduq3-pro, viduq3-turbo : 5 s par défaut, plage 1–16
- viduq2 : 5 s par défaut, plage 1–10
- viduq1 : 5 s par défaut, seulement 5
Graine aléatoire
Si omise ou 0, une valeur aléatoire est utilisée
Si définie manuellement, cette graine est utilisée
Résolution ; par défaut selon modèle et durée :
- viduq3-pro, viduq3-turbo (1–16 s) : 720p par défaut, autorisé 540p, 720p, 1080p
- viduq2 (1–10 s) : 720p par défaut, autorisé 540p, 720p, 1080p
- viduq1 (5 s) : 1080p par défaut, autorisé 1080p
Amplitude de mouvement
Par défaut auto ; autorisé : auto, small, medium, large
Remarque : sans effet avec le modèle q2
Paramètre en transit
Non traité ; transfert de données uniquement
Remarque : 1048576 caractères maximum
Mode hors pointe ; par défaut false ; autorisé :
- true : génération en mode hors pointe
- false : génération immédiate
Remarque 1 : le mode hors pointe consomme moins de crédits ; voir la tarification
Remarque 2 : les tâches hors pointe sont traitées sous 48 h ; les tâches non terminées sont annulées avec remboursement des crédits
Remarque 3 : vous pouvez annuler manuellement une tâche hors pointe
Ajouter un filigrane
- true : ajouter
- false : ne pas ajouter
Remarque 1 : contenu fixe (généré par IA) ; désactivé par défaut
Remarque 2 : vidéo avec filigrane via watermarked_url dans l’API de requête de tâche
Position du filigrane sur l’image :
1 : en haut à gauche
2 : en haut à droite
3 : en bas à droite
4 : en bas à gauche
Par défaut : 3
URL de l’image du filigrane
Si omise, texte par défaut : contenu généré par l’IA
Identifiant de métadonnées (chaîne JSON), en transit ; format personnalisé ou exemple :
{
"Label": "your_label","ContentProducer": "yourcontentproducer","ContentPropagator": "your_content_propagator","ProduceID": "yourproductid", "PropagateID": "your_propagate_id","ReservedCode1": "yourreservedcode1", "ReservedCode2": "your_reserved_code2"
}
Si vide, métadonnées Vidu par défaut
URL de rappel (POST). À définir à la création ; Vidu envoie les mises à jour de statut. Corps identique à l’API de requête de tâche.
Valeurs status du rappel :
- processing : en cours
- success : terminé (jusqu’à 3 tentatives en cas d’échec d’envoi)
- failed : échec (jusqu’à 3 tentatives en cas d’échec d’envoi)
Vidu utilise une signature de rappel ; voir la documentation
Image de la première image
Le modèle utilise l’image de ce paramètre comme première image pour générer la vidéo.
Remarque 1 : Base64 ou URL d’image (accessible)
Remarque 2 : une seule image
Remarque 3 : formats png, jpeg, jpg, webp
Remarque 4 : rapport d’aspect inférieur à 1:4 ou 4:1
Remarque 5 : taille max. 50 Mo
Remarque 6 : corps POST HTTP max. 20 Mo ; Content-Type approprié, ex. :
data:image/png;base64,{base64_encode}
Sortie audio-vidéo directe ; par défaut false ; autorisé :
- false : pas de sortie directe (vidéo muette)
- true : vidéo avec dialogue et son d’ambiance
Remarque 1 : voice_id ne s’applique que si true
Remarque 2 : si model est q3-pro ou q3-turbo, true par défaut
Remarque 3 : le mode hors pointe n’est pas pris en charge si true
ID de voix
Détermine le timbre dans la vidéo ; si vide, recommandation système. Liste : https://shengshu.feishu.cn/sheets/EgFvs6DShhiEBStmjzccr5gonOg
Utiliser les invites recommandées
- true : le système recommande des invites (nombre=1) et génère avec
- false : génération selon le prompt saisi
Remarque : les invites recommandées ajoutent 10 crédits par tâche
Responses
Succès