PixVerse V6.0 / C1 · Riferimento API
Genera video PixVerse da testo, immagini, fotogrammi di inizio e fine o riferimenti.
Utilizzare pixverse-video-v6.0 o pixverse-video-c1 come ID modello. Invia JSON con una chiave API APIMaster nell'intestazione Authorization: Bearer.
| Operazione | Endpoint |
|---|---|
| Text-to-video | POST /v1/wand/pixverse/text-to-video |
| Image-to-video | POST /v1/wand/pixverse/image-to-video |
| Cornici di avvio/fine | POST /v1/wand/pixverse/start-end-to-video |
| Reference-to-video | POST /v1/wand/pixverse/reference-to-video |
| Stato dell'attività | GET /v1/wand/pixverse/tasks/{task_id} |
| Campo | Tipo | Descrizione |
|---|---|---|
model |
string | Obbligatorio. Utilizzare uno degli ID del modello sopra. |
prompt |
string | Obbligatorio, fino a caratteri 5,000. I prompt di riferimento possono utilizzare @ref_name. |
duration |
integer | 1–15 secondi, anche a 1080p. Il valore predefinito è 5 secondi. |
quality |
string | Obbligatorio. 360p, 540p, 720p o 1080p. |
aspect_ratio |
string | Solo Text-to-video e reference-to-video. 16:9 (predefinito), 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 o 21:9. Altri percorsi seguono l'immagine di input. |
seed |
integer | Da 0 a 2,147,483,647. Ometti il campo o imposta 0 per un seed casuale. |
generate_audio_switch |
boolean | Imposta true per l'audio. Valore predefinito: false. |
camera_movement |
string | Movimento opzionale come zoom_in, per text-to-video e image-to-video. |
generate_multi_clip_switch |
boolean | Opzionale per V6.0 text-to-video e image-to-video. Valore predefinito: false. |
img_id |
string | Richiesto per image-to-video. Immagine pubblica URL o Base64. |
img_ids |
string[] | Riservato per un modello multi-immagine image-to-video. Una richiesta standard image-to-video utilizza img_id. |
first_frame_img, last_frame_img |
string | Obbligatorio per le richieste di start/end-frame. Utilizzare URLs pubblico o Base64. Usa i rapporti di aspetto corrispondenti. |
image_references |
object[] | Richiesto per reference-to-video. Fino a sette elementi con img_id, type opzionale (subject o background), e ref_name fino a caratteri 30. |
curl -X POST "https://apimaster.ai/v1/wand/pixverse/text-to-video" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"pixverse-video-v6.0","prompt":"A slow pan across a mountain lake","duration":5,"quality":"720p"}'
Richiedere ErrCode=0 e uno stato HTTP di successo. La risposta contiene ErrMsg, Resp.video_id e request_id. Sondaggio ogni secondo 3–5 con lo stesso account. Resp.status è 1 per il successo, 5 per l'elaborazione, 6 per l'eliminazione, 7 per il fallimento della revisione dei contenuti e 8 per il fallimento della generazione. Resp.url è il download temporaneo finale URL e dura fino a 12 ore. La risposta può anche includere dimensioni, dimensioni, seme, stile e timestamp.
Consultare lo stato non crea una nuova generazione e non comporta un altro addebito. Utilizzare un Idempotency-Key di 8–128 visibile caratteri ASCII per recuperare un invio. La stessa chiave con gli stessi parametri restituisce una ricevuta di recupero con codice HTTP 202. La stessa chiave con parametri diversi restituisce HTTP 409. Vedi Guida al recupero delle richieste. L'API non accetta un parametro prompt negativo o callback_url.
tokenhub_usage.total_tokens segnala l'utilizzo fatturabile. La risoluzione e le impostazioni audio influiscono sul prezzo. Vedi il PixVerse V6.0 e PixVerse C1 Schede modello per corrente APIMaster prezzi.
