APIMaster.ai

API video Wan 3.0

Parametri, combinazioni di media, attività asincrone, download e fatturazione al secondo per wan3.0-video su APIMaster.

API video Wan 3.0

wan3.0-video è il modello Wan 3 standard; è un modello separato da wan3.0-video-prime. Supporta testo, immagini, video, audio, documenti e pagine web pubbliche. Ogni attività completata con successo produce un video MP4/H.264, fino a 30 secondi. Integrazione verificata: 2026-11-17. Ogni richiesta accetta al massimo 20 elementi multimediali complessivi. Il video generato usa 30 fps.

Endpoint e autenticazione

Operazione Endpoint
Creazione POST https://apimaster.ai/v1/videos
Interrogazione GET https://apimaster.ai/v1/videos/{task_id}
Scaricamento GET https://apimaster.ai/v1/videos/{task_id}/content

Authorization: Bearer YOUR_API_KEY · Content-Type: application/json

Tutti i parametri della richiesta

Usa un formato multimediale per richiesta. Usa metadata.input.media per riferimenti multimediali misti o documenti.

Parametro Tipo Obbligatorio / predefinito Significato e valori validi
model string Obbligatorio Esattamente wan3.0-video; non sostituire con Prime
prompt string Obbligatorio Descrive il risultato in cinese o inglese; limite ufficiale 20.000 caratteri, il testo nativo più lungo viene troncato. Fare riferimento a Image 1, Video 1, Audio 1 nell'ordine dei media; ogni tipo di media ha la propria numerazione
duration integer 5 Da 2 a 30 secondi di output; -1 consente al modello di selezionare la durata. Con video di riferimento, la durata di input più quella di output non può superare 30 secondi
seconds string Facoltativo Alias della durata, ad es. "5" o "-1"; deve corrispondere a duration quando entrambi sono forniti
resolution string 1080P 480P, 720P, 1080P; i valori di livello superiore in minuscolo vengono normalizzati
aspect_ratio string adaptive adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16
ratio string Facoltativo Alias di aspect_ratio; adaptive è consigliato per l'estensione video
size string Facoltativo Alias di compatibilità: livello di risoluzione, o una mappatura di pixel supportata come 1280x720; preferire risoluzione e rapporto espliciti, non dimensioni arbitrarie in pixel
generate_audio boolean true a monte Indica se l'output ha una traccia audio. Un false esplicito viene preservato. L'audio non modifica la tariffa al secondo
audio boolean Facoltativo Alias di generate_audio; utilizzare un solo interruttore audio
prompt_extend boolean true Riscrittura intelligente del prompt; un false esplicito viene preservato. Deve essere true per input di documenti/pagine
watermark boolean false a monte Aggiunge una filigrana all'output; un false esplicito viene preservato
seed integer Casuale -1 o da 0 a 2147483647. L'omissione o -1 richiede un seed casuale; 0 viene inoltrato. Seed ripetuti non garantiscono un output identico
input_reference string Facoltativo URL dell'immagine del primo fotogramma; sostituisce l'array media nativo. Non mescolare stili di input
images string[] Facoltativo Array di comodità aggiunto come elementi reference_image quando input_reference è assente
metadata object Facoltativo Contenitore per gli oggetti nativi sottostanti; non può modificare il modello selezionato
metadata.input object Facoltativo Oggetto input nativo
metadata.input.prompt string Facoltativo Override del prompt nativo; mantenere il prompt obbligatorio di livello superiore
metadata.input.media object[] Facoltativo Array media ordinato. Ogni elemento richiede type e url; vedere i limiti di seguito
metadata.input.media[].type string Obbligatorio per elemento first_frame, last_frame, reference_image, reference_video, reference_audio, file, link
metadata.input.media[].url string Obbligatorio per elemento URL media HTTP(S) pubblico; i tipi immagine accettano anche una stringa data:{MIME_type};base64,.... I media non immagine richiedono un URL pubblico
metadata.parameters object Facoltativo Oggetto parametri nativo; non può essere null
metadata.parameters.resolution string 1080P 480P, 720P, 1080P in maiuscolo
metadata.parameters.ratio string adaptive Stessi valori di rapporto d'aspetto elencati sopra
metadata.parameters.duration integer 5 Da 2 a 30, oppure -1; stesso vincolo sulla durata combinata
metadata.parameters.audio boolean true a monte Stesso interruttore audio di output
metadata.parameters.prompt_extend boolean true Stesso interruttore di riscrittura del prompt; file/link richiede true
metadata.parameters.watermark boolean false a monte Stesso interruttore filigrana
metadata.parameters.seed integer Casuale Stesso intervallo del seed, incluso 0 esplicito

I campi nativi negative_prompt, img_url, first_frame_url, last_frame_url e audio_url non sono controlli media di Wan 3. Utilizzare invece l'array media documentato.

Limiti dei media e combinazioni valide

Tipo di media Quantità e vincoli
first_frame, last_frame Al massimo uno ciascuno. L'ultimo frame richiede il primo frame. I controlli dei frame non possono essere combinati con alcun tipo di riferimento, file o link
reference_image Al massimo 10. JPEG/JPG, PNG senza trasparenza, BMP o WEBP; ogni lato 240–8.000 pixel, rapporto d'aspetto massimo 8:1, ogni file massimo 20 MB
reference_video Al massimo 5 clip MP4/MOV; ciascuna 1–15 secondi, input combinato massimo 15 secondi; almeno 16 fps; ogni lato 240–4.096 pixel, rapporto d'aspetto massimo 8:1, ogni file massimo 100 MB
reference_audio Al massimo 5 clip WAV/MP3; ciascuna 1–15 secondi, combinato massimo 15 secondi; ogni file massimo 15 MB
file Al massimo un file DOCX/DOC/XLSX/XLS/PPTX/PPT/PDF/TXT/KEY/PAGES/NUMBERS/MD; massimo 100 MB. I documenti paginati PDF, DOCX, DOC, PPTX, PPT e KEY/PAGES hanno un limite di 50 pagine
link Al massimo una pagina accessibile pubblicamente senza login; non combinare con file

Le immagini, i video e gli audio di riferimento possono essere combinati. Un file o un link può accompagnare i media di riferimento. La modalità primo/ultimo frame accetta solo controlli dei frame; utilizzare la modalità immagine di riferimento più audio di riferimento per la generazione guidata dall'audio. L'analisi dei media e la moderazione dei contenuti restano soggette ai controlli upstream.

Il text-to-video utilizza un prompt senza media. L'animazione con primo frame utilizza first_frame; le transizioni utilizzano first_frame più last_frame. La generazione con riferimenti utilizza i tipi di riferimento. Per la modifica o l'estensione, fornire reference_video e descrivere la modifica o l'estensione nel prompt; utilizzare adaptive per l'estensione.

Esempi

Da testo a video

curl "https://apimaster.ai/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"wan3.0-video","prompt":"A paper boat drifting on a quiet pond, static camera.","duration":2,"resolution":"480P","aspect_ratio":"16:9","generate_audio":false,"prompt_extend":false,"watermark":false,"seed":0}'

Primo e ultimo fotogramma

{"model":"wan3.0-video","prompt":"Move smoothly from the first frame to the last.","duration":5,"resolution":"720P","metadata":{"input":{"media":[{"type":"first_frame","url":"https://example.com/start.png"},{"type":"last_frame","url":"https://example.com/end.png"}]}}}

Immagine e audio di riferimento

{"model":"wan3.0-video","prompt":"Animate Image 1 to the rhythm of Audio 1.","duration":5,"resolution":"720P","metadata":{"input":{"media":[{"type":"reference_image","url":"https://example.com/character.png"},{"type":"reference_audio","url":"https://example.com/music.mp3"}]}}}

Montaggio video / estensione e durata intelligente

{"model":"wan3.0-video","prompt":"Extend Video 1 forward as the camera follows the paper boat.","duration":-1,"resolution":"480P","aspect_ratio":"adaptive","metadata":{"input":{"media":[{"type":"reference_video","url":"https://example.com/input.mp4"}]}}}

Documento / pagina web

{"model":"wan3.0-video","prompt":"Create a product introduction based on this document.","duration":10,"resolution":"720P","prompt_extend":true,"metadata":{"input":{"media":[{"type":"file","url":"https://example.com/product.pdf"}]}}}

Sostituire tutti gli URL di esempio con media pubblici reali. Per l'input web, sostituire l'elemento file con {"type":"link","url":"https://example.com/product"}. L'esempio con il primo fotogramma funziona anche senza il suo elemento relativo all'ultimo fotogramma.

Risposte, polling, download e log

La creazione restituisce un ID attività APIMaster, non l'ID upstream:

{"id":"task_example","task_id":"task_example","object":"video","model":"wan3.0-video","status":"queued"}
Campo della risposta Significato
id / task_id Identificatore dell'attività della piattaforma utilizzato per la query e il download
status queued, in_progress, completed, failed
progress Indicatore di avanzamento; attendere lo stato terminale
error.code, error.message Informazioni sull'errore quando applicabile
metadata.url Posizione del contenuto quando restituita al completamento

Eseguire il polling all'incirca ogni 15 secondi utilizzando la stessa chiave API. Non creare un'altra attività per controllare l'avanzamento. Gli ID attività e gli URL di output del provider nativo scadono dopo 24 ore; scaricare e conservare tempestivamente i risultati riusciti. L'endpoint autenticato dei contenuti di APIMaster è preferibile rispetto alla memorizzazione di URL upstream temporanei.

curl "https://apimaster.ai/v1/videos/task_example" -H "Authorization: Bearer YOUR_API_KEY"
curl -L "https://apimaster.ai/v1/videos/task_example/content" \
  -H "Authorization: Bearer YOUR_API_KEY" -o wan3.mp4

Il log di utilizzo contiene l'attività e il risultato video riuscito. Controllare l'addebito finale dopo il completamento; l'accettazione non è prova del successo della generazione. Il polling ripetuto non crea un ulteriore costo di generazione.

Fatturazione

Consulta le tariffe al secondo nella scheda del modello.

APIMaster somma la durata di tutti i video di input e del video di output, arrotonda il totale una sola volta al secondo superiore e lo moltiplica per la tariffa al secondo della risoluzione di output scelta. Con 2,3 s in input e 5 s in output si fatturano 8 s. Senza video di input si fattura solo la durata dell’output. La richiesta non richiede un preventivo né la durata dell’input. Se la generazione fallisce, l’importo riservato viene sbloccato. L’importo finale è nel registro di utilizzo.

Errori e correzioni

Sintomo Correzione
Durata/risoluzione/proporzioni non valide Utilizzare l'enum e gli intervalli; la durata smart è esattamente -1
Conflitto frame/riferimento, ultimo con primo Seguire le regole di combinazione
File/link con estensione del prompt Impostare prompt_extend
Errore di recupero/formato/file multimediale Utilizzare file pubblici conformi ai vincoli di dimensione, formato e risoluzione
Prompt mancante Mantenere un prompt di primo livello non vuoto per l'APIMaster API
Attività fallita o modificata Controllare error, quindi correggere la richiesta; non considerare l'accettazione come successo