PixVerse V6

PixVerse V6 è il modello video di PixVerse. Un solo ID modello copre cinque modalità: da testo a video, da immagine a video, una transizione tra un primo e un ultimo fotogramma, riferimenti da più immagini ed estensione di una clip già creata. La modalità dipende dai campi che invii. Le clip durano 1–15 secondi a 360p, 540p, 720p o 1080p, con audio nativo facoltativo. Invia la richiesta, conserva l'ID attività restituito e leggi il video finito dall'attività. Le immagini vengono passate come URL.

ID modello

Consulta la pagina del modello per i prezzi attuali. Per una singola inquadratura più dettagliata da testo o da un'immagine, vedi PixVerse V6 Max.

Esempio rapido

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-v6",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
    "resolution": "540p",
    "duration": 5,
    "size": "16:9"
  }'

Endpoint

POST https://api.seedrouter.ai/v1/videos/generations

La risposta è un'attività ({"id": "task_...", "status": "processing"}), non il video finito. Interroga GET /v1/tasks/{task_id} per ottenere il risultato. Conserva le chiavi API nel codice lato server.

Parametri

Lo schema è rigoroso: i campi sconosciuti vengono rifiutati invece che ignorati. callback_url non è disponibile; interroga invece l'attività.

Modalità

I campi che invii scelgono la modalità. Invia i campi di una sola modalità per richiesta.

{
  "model": "pixverse-v6",
  "prompt": "The puppy slowly turns into a kitten, soft studio light.",
  "first_frame_image": "https://example.com/puppy.jpg",
  "last_frame_image": "https://example.com/kitten.jpg",
  "duration": 5
}

{
  "model": "pixverse-v6",
  "prompt": "The paper boat drifts on toward a lily pad.",
  "extend_from_task_id": "task_...",
  "resolution": "540p",
  "duration": 5
}

Un'estensione restituisce la clip di origine seguita dal nuovo segmento e addebita solo la duration del nuovo segmento. Nel nostro test, un'estensione di 1 secondo di una clip di 1 secondo è tornata con una durata di 2,1 secondi ed è stata addebitata come 1 secondo.

Input multimediali

Le immagini sono URL HTTP(S) pubblici. I data URI in base64 non sono accettati: carica il file nel tuo storage e passa il suo URL. Usa immagini JPG, PNG o WebP da 20 MB o meno.

Fattori di costo

Consulta la sezione prezzi del modello per le tariffe attuali. PixVerse V6 si paga per secondo di video, con una tariffa che dipende dalla risoluzione e dalla generazione o meno dell'audio:

cost = duration × rate per second for the resolution and audio setting

Ogni modalità costa uguale al secondo; un'estensione addebita solo il nuovo segmento. La durata è nota quando la richiesta è accettata, quindi l'importo riservato è l'importo addebitato. Consulta gli addebiti definitivi nella cronologia di utilizzo del tuo account. Le attività non riuscite non vengono addebitate.

Schema di output

L'invio restituisce l'attività:

{"id": "task_...", "model": "pixverse-v6", "status": "processing", "created_at": 1789689600}

Recuperare l'attività

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Interroga ogni 10–20 secondi finché status non diventa completed o failed. Un timeout di rete durante il polling non significa che la generazione sia fallita: conserva l'ID attività e riprendi il controllo. Non creare un'altra attività per verificare l'avanzamento.

Attività completata

{
  "id": "task_...",
  "model": "pixverse-v6",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689640,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

Nei nostri test, le clip di 1 secondo a 360p in 16:9 sono tornate come MP4 (H.264) a 640 × 360, 36–45 secondi dopo l'invio.

Errori

Le richieste rifiutate prima della creazione di un'attività restituiscono un errore HTTP con un oggetto error e non vengono addebitate. Un'attività che fallisce dopo l'accettazione restituisce HTTP 200 quando viene interrogata, con status: "failed" e un oggetto error.

Vedi il catalogo errori comune per codici, stati HTTP e indicazioni sui tentativi.

{
  "id": "task_...",
  "model": "pixverse-v6",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Se l'invio stesso va in timeout, controlla le tue attività prima di inviare di nuovo: la prima richiesta potrebbe essere stata accettata.

Suggerimenti

• Descrivi soggetto, luogo, movimento di camera e luce nel prompt; indica i suoni che vuoi quando audio è attivo.
• Fai le bozze a 360p o 540p, poi renderizza l'inquadratura finale a 1080p con la stessa richiesta e lo stesso seed.
• Per video verticali, invia size: "9:16" con la generazione da testo a video oppure un'immagine verticale.
• Aggiungi no text, no logos per evitare marchi inventati.

Correlati

• Playground e prezzi di PixVerse V6
• Riferimento API di PixVerse V6 Max
• Scarica l'OpenAPI
• Markdown copiabile