APIMaster.ai

Vidu Video Q4 Preview · Référence de l’API

Générez une vidéo à partir d'une seule image ou de références, puis interrogez la tâche APIMaster.

Utilisez POST /v1/wand/vidu/image-to-video pour une seule image de départ ou POST /v1/wand/vidu/reference-to-video pour la génération guidée par référence. Sondage avec GET /v1/wand/vidu/tasks/{task_id}. Utilisez JSON pour la soumission et l'authentification Bearer pour chaque demande. La génération de texte seul et un point de terminaison de début/fin de trame séparé ne sont pas disponibles pour ce modèle.

Champ Type Description
model string Obligatoire. Utilisez vidu-video-q4-preview.
images string[] Image-to-video nécessite exactement une image. Reference-to-video accepte jusqu'à 15 images ou subjects. Utilisez URLs ou des URI de données dans PNG, JPEG/JPG ou WebP. Le rapport d'aspect doit être 1:4 à 4:1. Chaque image URL peut être jusqu'à 50 MB. Les images Base64 sont limitées à 15 MB avant codage et 20 MB encodé au total.
subjects object[] Pour reference-to-video comme alternative à images. Réglez le name de chaque article et un à trois images. Référez-vous à un sujet avec @name dans l'invite.
prompt string Requis pour reference-to-video. Jusqu'à 2,000 caractères pour les références d'image directe ou 5,000 pour les sujets et image-to-video. Image-to-video ignore ce champ lorsque is_rec est activé.
auto_subjects boolean Option de bibliothèque de sujets pour reference-to-video. Valeur par défaut : false.
audio boolean Par défaut true pour image-to-video et false pour reference-to-video. La vidéo de référence avec audio nécessite subjects et une valeur explicite true.
audio_type string Lorsque l'audio est activé, utilisez all (par défaut), speech_only ou sound_effect_only.
is_rec boolean Recommandation automatique rapide pour image-to-video. L'activer augmente l'utilisation des tâches.
duration integer De 3 à 16 secondes, avec 5 par défaut.
resolution string 540p, 720p (par défaut), 1080p, 2K ou 4K.
aspect_ratio string Reference-to-video uniquement. Utilisez 16:9 (par défaut), 9:16, 3:4, 4:3 ou 1:1. Image-to-video suit l'image d'entrée.
seed integer Omettez le champ ou utilisez 0 pour une graine aléatoire.
payload string Données d'application facultatives, jusqu'à 1,048,576 caractères.
watermark boolean Valeur par défaut : false.
wm_url string Filigrane personnalisé en option URL. Le filigrane par défaut apparaît en haut à gauche. L'API n'accepte pas wm_position.
curl -X POST "https://apimaster.ai/v1/wand/vidu/image-to-video" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"vidu-video-q4-preview","images":["https://example.com/reference.jpg"],"prompt":"Slow camera pan","duration":5,"resolution":"720p"}'

Interrogez le statut toutes les 5–10 secondes avec le task_id et le même compte. Les États sont created, queueing, processing, success et failed. En cas de succès, creations[].url est la vidéo et creations[].cover_url est sa couverture. Télécharger des liens temporaires dans les heures 12. Conservez request_id lorsque vous signalez un échec.

Utilisez un Idempotency-Key de caractères 8–128 visibles ASCII pour récupérer une soumission. La même clé et les mêmes paramètres renvoient un reçu de récupération avec le statut HTTP 202. La même clé avec des paramètres différents renvoie le statut HTTP 409. Voir Guide de récupération des requêtes. Les timeouts de requête peuvent être re-essayés sans créer une nouvelle vidéo.

La passerelle règle la génération une fois. tokenhub_usage.total_tokens signale une utilisation facturable. Voir le Vidu Video Q4 Preview modèle card pour le prix actuel APIMaster.