PixVerse V6 API

PixVerse V6 Référence vers vidéo crée un clip à partir d’images que vous envoyez, jusqu’à 7 éléments dans une même requête. PixVerse appelle ce mode Fusion. Chaque élément a un nom, une image et un rôle : subject pour une personne, un animal, un objet ou un produit, ou background pour un lieu ou un décor. Écrivez @name dans le prompt à l’endroit où chaque élément doit apparaître. Les clips durent de 1 à 15 secondes, de 360p à 1080p, dans huit ratios d’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

Nommez vos éléments

Donnez à chaque élément un nom de 1 à 30 caractères et appelez-le avec @name dans le prompt. Dans notre test, maya (une photo d’une femme rousse en veste moutarde) et trailer (une photo d’une caravane de voyage chromée) sont devenus un plan de crépuscule : elle marche vers la caméra avec une tasse en émail fumante, devant la caravane aux guirlandes lumineuses allumées. Son visage, ses cheveux et sa veste correspondaient à la référence, et la caravane aussi.

Mettez un espace après le nom

Dans notre test, "@trailer," avec une virgule juste après le nom a été refusé parce que le nom ne correspondait pas, tandis que "@trailer and" a fonctionné. Les requêtes échouées ne sont pas facturées. Écrivez @name suivi d’un espace.

Sujets et arrière-plans

Réglez role sur subject (par défaut) pour les personnes, animaux, objets et produits, ou sur background pour un lieu. Une même requête peut mélanger jusqu’à 7 éléments de ces deux types.

De petits artefacts arrivent

Dans notre exemple, une image montrait brièvement une seconde silhouette dans l’embrasure de la porte. Vérifiez le clip avant de le publier.

Placer une personne dans un lieu où elle n’a jamais été photographiée

Un portrait comme élément et une photo d’un lieu comme arrière-plan, avec l’action décrite dans le prompt.

Garder un véhicule ou un produit cohérent

Donnez à une voiture, une caravane ou un produit son propre élément pour qu’il corresponde à sa photo dans chaque clip.

Tourner une courte scène

Nommez deux ou trois éléments, dites comment ils se rencontrent et ajoutez un mouvement de caméra.

# 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/reference-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "elements": [
      {
        "name": "example",
        "image_url": "https://example.com/reference.png"
      }
    ],
    "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.