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.
