Créer une tâche texte-vers-vidéo
- Documentation officielle : https://platform.vidu.cn/docs/text-to-video
- Crée une tâche texte-vers-vidéo et renvoie task_id
- Contrôlez la génération via model, prompt et d'autres paramètres
Authorizations
Request Body
Invite textuelle (prompt)
Description textuelle pour la génération vidéo.
Remarque : 2000 caractères maximum
Nom du modèle
Valeurs autorisées : viduq3-turbo, viduq3-pro, viduq2, viduq1
- viduq3-turbo : génération plus rapide que viduq3-pro
- viduq3-pro : audio-vidéo de haute qualité ; rendu plus vivant et expressif
- viduq2 : modèle le plus récent
- viduq1 : image nette, transitions fluides, mouvement de caméra stable
Style
Par défaut general ; valeurs : general, anime
general : style général ; contrôle via le prompt
anime : style anime ; rendu anime marqué ; contrôle via différents prompts anime
Remarque : sans effet avec le modèle q2
Durée de la vidéo ; la valeur par défaut dépend du 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, seule valeur 5
Graine aléatoire (seed)
Si omis ou 0, une valeur aléatoire est utilisée
Si défini manuellement, cette graine est utilisée
Format (ratio)
Par défaut 16:9 ; valeurs : 16:9, 9:16, 3:4, 4:3, 1:1
Remarque : 3:4 et 4:3 uniquement avec le modèle q2
Résolution ; la valeur par défaut dépend du modèle et de la durée :
- viduq3-pro, viduq3-turbo (1–16 s) : 720p par défaut, valeurs 540p, 720p, 1080p
- viduq2 (1–10 s) : 720p par défaut, valeurs 540p, 720p, 1080p
- viduq1 (5 s) : 1080p par défaut, valeur 1080p
Amplitude de mouvement
Par défaut auto ; valeurs : auto, small, medium, large
Remarque : sans effet avec le modèle q2
Ajouter ou non une musique de fond à la vidéo générée.
Par défaut false ; valeurs true, false
Si true, le système choisit une musique adaptée dans la bibliothèque BGM.
- Durée BGM non limitée ; adaptée à la durée de la vidéo
Paramètre en transit (passthrough)
Non traité ; transfert de données uniquement
Remarque : 1048576 caractères maximum
Ajouter ou non un filigrane
- true : ajouter un filigrane
- false : pas de filigrane
Remarque 1 : contenu du filigrane fixe (généré par IA) ; désactivé par défaut
Remarque 2 : vidéo avec filigrane via le paramètre watermarked_url de 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
Contenu du filigrane (URL d'image)
Si omis, 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 générées par Vidu par défaut
URL de rappel (POST). Définissez callback_url à la création ; Vidu envoie les mises à jour de statut à cette URL. Le corps correspond à la réponse de l'API de requête de tâche.
Valeurs de status dans le 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 l'authentification par signature de rappel ; voir la documentation de signature
Responses
Succès