APIMaster.ai

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.