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 |
