PixVerse V6 API

PixVerse V6 Reference to video crea una clip a partire dalle immagini che invii, fino a 7 elementi in una sola richiesta. PixVerse chiama questa modalità Fusion. Ogni elemento ha un nome, un’immagine e un ruolo: subject per una persona, un animale, un oggetto o un prodotto, oppure background per un luogo o un’ambientazione. Scrivi @name nel prompt dove deve comparire ciascun elemento. Le clip durano da 1 a 15 secondi, da 360p a 1080p, in otto proporzioni. PixVerse verifica prompt e immagini prima della generazione; le richieste che rifiuta falliscono e non vengono addebitate.

Scegli una modalità PixVerse V6 in base al materiale di partenza

Dai un nome agli elementi

Dai a ogni elemento un nome di 1-30 caratteri e richiamalo con @name nel prompt. Nel nostro test maya (una foto di una donna dai capelli rossi con una giacca color senape) e trailer (una foto di un rimorchio cromato) sono diventati un’inquadratura al crepuscolo di lei che cammina verso la camera con una tazza di smalto fumante davanti al rimorchio, con le luci a filo accese. Il suo viso, i capelli e la giacca corrispondevano al riferimento, e così il rimorchio.

Metti uno spazio dopo il nome

Nel nostro test «@trailer,» con una virgola subito dopo il nome è stato rifiutato perché il nome non corrispondeva, mentre «@trailer and» ha funzionato. Le richieste fallite non vengono addebitate. Scrivi @name seguito da uno spazio.

Soggetti e sfondi

Imposta role su subject (default) per persone, animali, oggetti e prodotti, oppure su background per un luogo. Una richiesta può mescolarne fino a 7.

Possono comparire piccoli artefatti

Nel nostro esempio, in un fotogramma una seconda figura è comparsa per un attimo sulla porta. Controlla la clip prima di pubblicarla.

Inserire una persona in un luogo in cui non è mai stata fotografata

Un ritratto come elemento e la foto di una location come sfondo, con l’azione scritta nel prompt.

Mantenere coerenti un veicolo o un prodotto

Dai a un’auto, a un rimorchio o a un prodotto un elemento proprio, così corrisponde alla sua foto in ogni clip.

Mettere in scena una breve scena

Nomina due o tre elementi, dici come si incontrano e aggiungi un movimento di macchina.

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

Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.