Video
PixVerse V6 Max
Genera clip di PixVerse V6 Max di 1–15 secondi da un prompt o un'immagine, da 360p a 1080p con audio facoltativo, addebitate al secondo e consegnate come attività.
PixVerse V6 Max è la versione più dettagliata di PixVerse V6. Crea una clip di 1–15 secondi da un prompt oppure da un'immagine iniziale con un prompt facoltativo, 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
| ID modello | Input | Risoluzioni | Durata |
|---|---|---|---|
pixverse-v6-max | testo, un'immagine | 360p, 540p, 720p, 1080p | 1–15 secondi |
Consulta la pagina del modello per i prezzi attuali. Transizioni, riferimenti da più immagini ed estensione sono funzioni di PixVerse V6.
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-max",
"prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
"resolution": "720p",
"duration": 5,
"aspect_ratio": "16:9"
}'Endpoint
POST https://api.seedrouter.ai/v1/videos/generations| Intestazione | Valore |
|---|---|
| Authorization | Bearer YOUR_API_KEY |
| Content-Type | application/json |
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
| Campo | Tipo | Predefinito | Note |
|---|---|---|---|
model | string | obbligatorio | pixverse-v6-max |
prompt | string | vedi note | Da testo a video: obbligatorio, fino a 5.000 caratteri. Con un'immagine: facoltativo, fino a 2.048 caratteri. |
image_urls | elenco di URL | nessuno | Da immagine a video: esattamente un'immagine. Senza, la clip è da testo a video. |
resolution | enum | 540p | 360p, 540p, 720p o 1080p. |
quality | enum | nessuno | Alias di resolution, stessi valori. resolution ha la precedenza quando vengono inviati entrambi. |
duration | integer | 5 | 1–15 secondi. |
aspect_ratio | enum | 16:9 | 16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 o 21:9. Solo da testo a video; con un'immagine, la clip segue l'immagine. |
audio | boolean | false | Genera audio nativo. Addebitato alla tariffa audio. |
seed | integer | nessuno | 0–2147483647. La stessa richiesta e lo stesso seed danno risultati simili. |
Lo schema è rigoroso: i campi sconosciuti vengono rifiutati invece che ignorati. first_frame_image, last_frame_image, img_references ed extend_from_task_id restituiscono un errore 400 che rimanda a pixverse-v6. callback_url non è disponibile; interroga invece l'attività.
Da immagine a video
Passa un'immagine in image_urls. La clip parte da questa immagine e ne mantiene la forma, quindi un'immagine verticale produce una clip verticale. Qui il prompt è facoltativo.
{
"model": "pixverse-v6-max",
"prompt": "The subject slowly turns toward the camera, soft natural light.",
"image_urls": ["https://example.com/start.png"],
"resolution": "1080p",
"duration": 5
}Input multimediali
L'immagine è un URL HTTP(S) pubblico. I data URI in base64 non sono accettati: carica il file nel tuo storage e passa il suo URL. Usa un'immagine JPG, PNG o WebP da 20 MB o meno, al massimo 10.000 pixel per lato.
Fattori di costo
Consulta la sezione prezzi del modello per le tariffe attuali. PixVerse V6 Max 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 settingDa testo a video e da immagine a video costano uguale. 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-max", "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-max",
"status": "completed",
"created_at": 1789689600,
"finished_at": 1789689690,
"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, 81–89 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-max",
"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
360po540p, poi renderizza l'inquadratura finale a1080pcon la stessa richiesta e lo stessoseed. - Per video verticali, invia
aspect_ratio: "9:16"oppure un'immagine verticale. - Aggiungi
no text, no logosper evitare marchi inventati.
