Vidu Q3 Turbo API

Vidu Q3 Turbo est le niveau rapide de la gamme Q3 de Vidu, proposé sous la forme de points de terminaison d’image vers vidéo et de video-extend ; cette page traite l’image vers vidéo. Une image d’ouverture dans image_url fixe le sujet et la forme de la sortie, un prompt obligatoire dirige le mouvement, la caméra et le son, et les clips durent de 1 à 16 secondes entières en 540p ou 720p, 720p par défaut. L’audio est généré dans la même passe et reste activé tant que vous ne passez pas generate_audio à false. Ce niveau est pensé pour essayer de nombreux mouvements à partir d’une seule image avant de choisir la prise à livrer.

Une valeur d’ébauche et une valeur de livraison

resolution accepte 540p ou 720p, et 720p est à la fois la valeur par défaut et le plafond de ce point de terminaison. Les deux valeurs fonctionnent en paire : 540p pour les passes où le mouvement se cherche encore, 720p pour la prise livrée. La résolution étant un seul champ, passer de l’une à l’autre ne touche ni au prompt, ni à l’image, ni au seed.

De courtes variantes à partir d’une image

La durée va de 1 à 16 secondes entières, et une à quatre secondes est la plage pratique pour les passes de variantes. Générez une série de prises courtes à partir de la même image, chacune avec un seul mouvement différent, et gardez celles qui fonctionnent plutôt que d’écrire une consigne élaborée en espérant qu’elle tombe juste.

L’image fixe le sujet et la forme

Le sujet, la tenue, le stylisme, le cadrage et la forme de sortie viennent de l’image, pas du prompt : deux essais à partir d’une même image diffèrent par le mouvement, pas par la personne à l’écran. movement_amplitude règle l’ampleur générale du mouvement ; le prompt décide de ce qui bouge. Un texte qui contredit l’image produit un clip qui négocie entre les deux, alors gardez le prompt cohérent avec ce que montre l’image.

Des séries de réactions de personnage

Une image en costume devient une révérence, un clin d’œil, un signe de la main et une inclinaison de la tête : quatre requêtes, la même image, quatre prompts. Comme l’image fixe l’identité, la série reste assez cohérente pour être montée dans un fil.

Des formats carrés et verticaux pour les réseaux

La forme de sortie vient de l’image : un portrait 9:16 et un carré 1:1 sont deux exports de l’étape image, pas deux réglages vidéo différents. Chacun s’anime en un clip 720p avec un son déjà synchronisé.

Tester un mouvement de caméra sur une image

L'exemple de push-in demande un seul mouvement et rien d'autre : le cadre se resserre progressivement jusqu'à ne plus montrer que son épaule. Reprenez ce schéma pour vérifier qu’un sujet tient à mesure que le cadre se referme, avant d’écrire une consigne plus longue.

Des boucles sans censure à partir de vos propres images

Les images sources sans censure sont animées telles quelles, et la plage d’une à quatre secondes convient pour constituer une série de courtes variantes à partir de quelques images. Vidu Q3 Spicy, de la même gamme, est la variante sans censure réglée par LoRA.

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "vidu/q3-turbo/image-to-video",
  "input": {
    "duration_seconds": 5,
    "image_url": "https://example.com/reference.png",
    "movement_amplitude": "auto",
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "720p"
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.