PixVerse V6 API

PixVerse V6 Texte vers vidéo transforme un brief écrit en clip de 1 à 15 secondes, en 360p, 540p, 720p ou 1080p, dans huit ratios d’image, de 16 :9 à 9 :16 et 21 :9. Décrivez le sujet, l’action et la caméra ; les mouvements de caméra écrits dans le prompt sont suivis, et PixVerse indique que V6 comprend plus de 20 commandes cinématographiques d’objectif et de caméra à partir du prompt. Activez generate_audio et le modèle génère le son avec l’image. PixVerse contrôle les prompts et les images avant la génération ; les requêtes qu’il refuse échouent et ne sont pas facturées.

Choisir un mode PixVerse V6 selon le matériau de départ

Un paragraphe, plusieurs cadrages

Dans notre test, un seul paragraphe sur une conductrice qui rit dans une décapotable vintage bleu sarcelle a commencé par un plan serré, foulard au vent, puis la caméra s’est élevée vers une vue aérienne large de la voiture sur une route de falaise, au-dessus de l’océan. Le prompt demandait au drone de reculer et de s’élever ; le passage du gros plan à la vue aérienne vient du modèle.

Un interrupteur multi-plans

shot_type vaut single par défaut. Mettez multi pour laisser le modèle découper le clip en plusieurs plans. Cela ne modifie pas le prix.

Huit ratios d’image

16 :9 (par défaut), 4 :3, 1 :1, 3 :4, 9 :16, 2 :3, 3 :2 et 21 :9. Le ratio d’image ne modifie pas le prix.

Le son quand vous le voulez

generate_audio est désactivé par défaut. Activé, le modèle génère l’ambiance, les effets, la musique et les dialogues que vous écrivez entre guillemets. Le son coûte plus cher à la seconde.

Quatre résolutions

360p, 540p, 720p (par défaut) et 1080p. Notre clip de test était en 540p, 1024x576, et a demandé environ 41 secondes de calcul du modèle pour 5 secondes de vidéo.

Plans d’ouverture et plans d’établissement

Décrivez le lieu, la lumière, un mouvement de caméra et le rendu, et vous obtenez un plan pour ouvrir une scène. Notre exemple de route de falaise fait exactement cela en un seul paragraphe.

Scènes courtes avec une réplique parlée

Activez l’audio, décrivez l’action et mettez la réplique entre guillemets. Nommez dans le même prompt l’ambiance voulue.

Cadrages verticaux et ultralarges

Choisissez 9 :16, 3 :4 ou 2 :3 pour des clips verticaux, ou 21 :9 pour l’ultralarge. Le prix par seconde est le même pour chaque ratio d’image.

# 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": "pixverse/v6/text-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "shot_type": "single",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": false,
    "duration_seconds": 5
  }
}'

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