Vidu Q3 Pro API

Vidu Q3 Pro est le niveau Pro de la gamme vidéo Q3 de Vidu, proposé sous la forme d’un point de terminaison unique d’image vers vidéo. Vous envoyez une image d’ouverture dans image_url et une consigne dans prompt, toutes deux obligatoires, et vous recevez de 1 à 16 secondes entières de vidéo en 540p, avec un son généré dans la même passe. L’image fixe le sujet, le rendu et la forme de la sortie ; il n’y a pas de champ de format d’image et le rapport de l’image doit rester entre 1:4 et 4:1. Le prompt n’a donc qu’à décrire ce qui bouge.

Une seule résolution, seule la durée se décide

resolution n’accepte qu’une valeur, 540p, et chaque clip revient à cette taille. Reste duration_seconds – tout nombre entier de 1 à 16, 5 par défaut –, le réglage qui modifie à la fois la longueur du clip et le prix ; l’estimation en direct le suit à mesure que vous le déplacez.

L’identité vient de l’image fixe

Le sujet, la tenue, le cadrage et la forme de sortie sont fixés par l’image, pas par le prompt. Deux essais à partir de la même image diffèrent par le mouvement, pas par la personne à l’écran, ce qui permet de monter ensemble une série de clips issus d’une seule image. La requête vidéo ne peut pas non plus réécrire ce qui a été validé à l’étape image.

Écrire le mouvement, puis régler son ampleur

movement_amplitude règle l’ampleur générale du mouvement – auto par défaut, ou small, medium, large – et le prompt dit ce qui bouge et comment. Quand une prise bouge trop ou pas assez, gardez seed et l’image fixes et reformulez seulement le mouvement – un demi-tour plus court, une marche plus lente – pour que la différence observée vienne de cette seule modification et non d’un nouveau tirage.

Des séries de réactions pour un personnage

Une image en costume devient un clin d’œil, un signe de la main, une inclinaison de la tête et un demi-tour : quatre requêtes avec la même image et quatre prompts différents. Comme l’identité est fixée par l’image, la série se monte sans que personne ne dérive d’un clip à l’autre.

Une action rapprochée et rythmée

L’exemple de la forge reste serré six secondes sur le torse et les avant-bras d’un forgeron, éclairés par le feu en contre-plongée, avec des étincelles à chaque coup de marteau. Les impacts répétés sont un bon test pour ce point de terminaison : les étincelles doivent jaillir sur les coups, pas entre eux.

Des livrables verticaux

Exportez l’image en 9:16 et le clip revient à la verticale. Dans l’exemple du passage souterrain, le prompt ne porte que la marche vers l’objectif sous les néons et une caméra qui recule à son rythme ; le cadrage vertical a été décidé à l’étape image.

Des scènes sans censure à partir de votre propre image

Votre image est animée telle quelle au lieu d’être adoucie, et comme l’image porte le contenu, le résultat reste proche de ce qui a été validé. Vidu Q3 Spicy, dans 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-pro/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": "540p"
  }
}'

# 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.