Risposta rapida
Wan 2.7 è la suite multimodale di generazione video di Alibaba per flussi di lavoro da testo a video, da immagine a video, generazione guidata da riferimenti ed editing. Tramite Wan 2.7 su CometAPI, gli sviluppatori usano l’ID modello wan2.7 con l’endpoint asincrono POST /v1/videos. L’integrazione ha tre fasi operative: inviare un’attività, fare polling dell’ID video restituito e scaricare l’MP4 completato. La rotta live supporta output 720p e 1080p e indica il prezzo al secondo, quindi durata e risoluzione determinano il costo stimato di generazione. Inizia con una richiesta da testo a video di 5 secondi in 720p, valida il workflow, quindi aggiungi riferimenti immagine o una risoluzione superiore solo dopo che la rotta di base funziona.
Importante: Questo guida copre Wan 2.7 Video tramite CometAPI. Non descrive il modello Wan di sola generazione di immagini, quindi specifiche solo-immagine come l’output 4K di immagini statiche non sono considerate funzionalità di Wan 2.7 Video.
Punti chiave
- CometAPI espone Wan 2.7 tramite un endpoint video asincrono in stile OpenAI anziché una risposta chat sincrona.
- La rotta usa l’ID modello wan2.7 e POST /v1/videos.
- Un’integrazione completa deve conservare l’ID del video restituito, eseguire polling dell’endpoint di stato, gestire i fallimenti terminali e scaricare l’MP4 solo dopo il successo.
- L’API nativa di Alibaba per il testo‑video di Wan 2.7 supporta 720P e 1080P con durata 2‑15 secondi; la rotta CometAPI usa nomi di campi unificati propri.
- Flussi da immagine a video, primo/ultimo fotogramma e continuazione esistono nella famiglia nativa del modello Alibaba, ma i campi avanzati disponibili tramite la rotta unificata vanno verificati rispetto alla documentazione della rotta live.
- Le evidenze di benchmark pubblici sono più solide per il video‑to‑video: Wan 2.7 è arrivato primo nella categoria Design Arena. Quel risultato non va generalizzato a ogni task da testo a video o da immagine a video.
- La metrica di produzione più utile è il costo per clip accettata, non solo il prezzo per secondo generato.
Che cos’è Wan 2.7?
Wan 2.7 in termini semplici per sviluppatori
Wan 2.7 non è solo un checkpoint prompt‑to‑video. Alibaba descrive una famiglia video in quattro parti che comprende Wan2.7-t2v, Wan2.7-i2v, Wan2.7-r2v e Wan2.7-videoedit. Insieme, queste varianti coprono la generazione da testo, l’animazione da immagini, il controllo di soggetto o stile guidato da riferimenti e la trasformazione di video esistenti. Questo conta per il design applicativo: una semplice clip di marketing può usare solo il testo‑video, mentre una pipeline di produzione con coerenza di personaggio può richiedere input di riferimento, fotogrammi ancorati, guida audio ed editing iterativo.
Su CometAPI, la rotta comprime intenzionalmente la nomenclatura specifica del provider nell’ID cliente del modello wan2.7. La capacità di generazione sottostante resta Wan 2.7, ma autenticazione, percorsi degli endpoint e nomi dei parametri differiscono dall’API nativa Alibaba Cloud.
Specifiche tecniche di Wan 2.7
| Specifica | Wan 2.7 Video |
|---|---|
| Provider | Alibaba / Wan |
| ID modello CometAPI | wan2.7 |
| ID nativi text‑to‑video | wan2.7-t2v, wan2.7-t2v-2026-06-12 |
| ID nativo image‑to‑video | wan2.7-i2v-2026-04-25 |
| Input principali | Testo; immagine, audio o video nei flussi supportati |
| Output principale | Video generato con comportamento audio supportato |
| Modalità | T2V, I2V, R2V, video editing, primo/ultimo fotogramma, continuazione |
| Risoluzione | 720P e 1080P |
| Durata T2V | 2‑15 secondi; predefinito 5 secondi |
| Formati T2V | 16:9, 9:16, 1:1, 4:3, 3:4 |
| Limite prompt | 5.000 caratteri per T2V nativo Wan 2.7 |
| Limite prompt negativo | 500 caratteri |
| Formati e limiti audio | WAV/MP3; 2‑30 secondi; fino a 15 MB |
| Invocazione | Asincrona |
| Architettura / numero di parametri | Non confermato in modo completo nella documentazione API ufficiale |
Specifica di confine: alcune pagine di catalogo descrivono un’architettura o un numero di parametri, ma la documentazione ufficiale dell’API video di Alibaba non pubblica una specifica architetturale completa per ogni variante di Wan 2.7. L’espressione editoriale più prudente è che il conteggio completo dei parametri e l’architettura non sono divulgati in modo esaustivo.
Cosa può fare Wan 2.7?
Da testo a video con prompt multi‑shot temporizzati.
Wan 2.7 può interpretare i cambi di inquadratura scritti direttamente nel prompt. Uno sviluppatore può descrivere Shot 1, Shot 2 e Shot 3 con intervalli temporali invece di fare affidamento su un campo di controllo degli shot separato. Questo rende il prompt uno storyboard compatto.
Controllo del primo e dell’ultimo fotogramma.
Il flusso nativo da immagine a video accetta media di primo fotogramma e ultimo fotogramma affinché il modello sintetizzi il movimento tra due ancore visive. È utile per transizioni di prodotto, cambi di posa e morphing di scena.
Continuazione video.
Un input nativo di tipo first_clip condiziona la porzione successiva del video. In questo flusso, la durata va interpretata secondo le regole del task del provider, quindi le applicazioni non dovrebbero assumere che significhi sempre e solo il segmento appena generato.
Generazione guidata dall’audio.
Alibaba documenta l’audio come sorgente guida per tempistica e sincronizzazione labiale. Senza un asset audio caricato, il modello può generare musica di sottofondo o effetti sonori abbinati. L’audio più lungo del video richiesto viene troncato; se più corto, il resto del video resta silenzioso.
Estensione del prompt, prompt negativi e filigrana.
L’API nativa supporta riscrittura del prompt, prompt negativi e un’opzione di filigrana generata dall’IA. Questi controlli aiutano i team a standardizzare la qualità del prompt e il comportamento di provenienza, sebbene i campi unificati di CometAPI possano non avere una corrispondenza uno‑a‑uno.
Cosa dicono i benchmark pubblici su Wan 2.7?
I modelli video non hanno un benchmark universalmente accettato equivalente ai punteggi MMLU o SWE‑bench di un LLM. Per Wan 2.7, il segnale esterno pubblicato più chiaro è che ha ottenuto il primo posto nella categoria Design Arena video‑to‑video. L’immagine di ranking della pubblicazione ufficiale mostra Wan 2.7 con un Elo di 1335 in quel momento. Questo supporta un’affermazione sulla preferenza per trasformazione/editing video; non prova una leadership universale in testo‑video, immagine‑video, qualità audio o latenza.
| Evidenza | Risultato pubblico | Come interpretarlo |
|---|---|---|
| Design Arena video‑to‑video | Primo; Elo 1335 nell’immagine pubblicata | Forte evidenza di preferenza per V2V |
| Specifiche API ufficiali | 720P/1080P; 2‑15 secondi per T2V | Flessibilità produttiva, non classifica di qualità |
| Punteggio T2V standardizzato | Non divulgato pubblicamente | Usare un A/B test interno |
| Punteggio I2V standardizzato | Non divulgato pubblicamente | Usare un A/B test interno |
| Latenza o tasso di successo | Non standardizzati pubblicamente | Misurare sulla rotta selezionata |
Conclusione sui benchmark
- Usa il risultato di Design Arena come evidenza della competitività nel video‑to‑video, non come affermazione generale per ogni modalità.
- Non riutilizzare numeri di benchmark di Wan 2.1 come risultati di Wan 2.7.
- Per la selezione in produzione, testa stessi prompt, asset sorgenti, risoluzione, durata e condizioni audio tra i modelli.
- Traccia tasso di accettazione umana, stabilità del movimento, preservazione dell’identità, latenza, tasso di fallimento e costo per clip accettata.
Perché usare Wan 2.7 tramite CometAPI?
Un’API video unificata
CometAPI espone il modello tramite un ciclo di vita video asincrono comune. L’attuale pagina del modello Wan 2.7 pubblica l’ID modello cliente, i prezzi della rotta e un pattern funzionante di creazione‑polling‑download. Questo riduce il codice d’integrazione specifico del provider quando un prodotto deve testare o instradare tra diversi modelli video.
POST /v1/videos GET /v1/videos/{video_id} GET /v1/videos/{video_id}/content

(Il ciclo di vita create‑poll‑download di CometAPI per la generazione video asincrona. Fonte endpoint: documentazione API di CometAPI.)
- Una sola chiave API per più modelli video supportati.
- Un pattern coerente per creazione task, recupero stato e download file.
- Visibilità centralizzata su utilizzo e fatturazione.
- Meno codice applicativo legato all’autenticazione e allo schema di risposta di un singolo provider.
- A/B test più rapidi perché la selezione del modello può cambiare senza sostituire l’intero ciclo del task.
Una necessaria nota di compatibilità
Compatibilità della rotta: lo schema unificato /v1/videos di CometAPI non espone necessariamente ogni campo delle API native T2V, I2V, R2V e di video editing di Alibaba Cloud. I flussi base da testo a video e da immagine a video sono i punti di partenza più sicuri. Prima di distribuire controllo del primo/ultimo fotogramma, input multi‑riferimento, guida audio o editing video, verifica i campi e i limiti media esatti della rotta live.
Cosa serve prima di iniziare
Crea un account CometAPI e una chiave API
Crea o accedi a un account CometAPI, quindi genera una chiave API. Conservala in una variabile d’ambiente. Non inserire la chiave nel controllo versione, nel codice browser o nelle applicazioni mobili.
export COMETAPI_KEY="your_api_key"$env:COMETAPI_KEY="your_api_key"
Conosci l’ID del modello e gli endpoint
Model ID: wan2.7 Create endpoint: POST https://api.cometapi.com/v1/videos Status endpoint: GET https://api.cometapi.com/v1/videos/{video_id} Download endpoint: GET https://api.cometapi.com/v1/videos/{video_id}/content
Installa il pacchetto Python
python -m pip install --upgrade requests
Gli esempi usano richieste HTTP raw perché form‑data multipart, polling di stato e download binari sono più facili da capire senza un’ulteriore astrazione SDK.
Come usare l’API Wan 2.7 con CometAPI
Passo 1: crea un task da testo a video
Invia una richiesta multipart con modello, prompt, durata e dimensione. Questo esempio di 5 secondi a 720p è il modo a minor rischio per validare credenziali, instradamento e creazione del task.
curl https://api.cometapi.com/v1/videos \ -H "Authorization: Bearer $COMETAPI_KEY" \ -F "model=wan2.7" \ -F "prompt=A cinematic tracking shot of a futuristic train crossing a snowy mountain valley at sunrise, smooth camera motion, realistic light." \ -F "seconds=5" \ -F "size=1280x720"The response should include a task identifier under id or task_id. Log the full response during integration because providers and route versions may wrap status data differently.{ "id": "video_task_id", "status": "queued", "progress": 0 }
Passo 2: fai polling dello stato del video
Usa l’ID restituito nell’endpoint di stato. Fare polling ogni 10‑15 secondi è generalmente più appropriato dei loop stretti per un task video ad alta intensità di calcolo.
curl https://api.cometapi.com/v1/videos/{video_id} \ -H "Authorization: Bearer $COMETAPI_KEY"{ "id": "video_task_id", "status": "in_progress", "progress": 45 }
La tua applicazione dovrebbe considerare completed o success come stati terminali positivi e failed, error o FAILURE come stati terminali negativi. Conserva il payload completo del fallimento per la diagnosi.
Passo 3: scarica l’MP4 completato
Scarica solo dopo che l’attività raggiunge uno stato terminale positivo. Salvare una risposta da un task incompleto può creare un file vuoto o un documento di errore con estensione MP4.
curl https://api.cometapi.com/v1/videos/{video_id}/content \ -H "Authorization: Bearer $COMETAPI_KEY" \ --output wan2_7_output.mp4
Passo 4: genera video a partire da un’immagine
Per l’image‑to‑video, carica il riferimento come form‑data multipart e usa un prompt che descriva il movimento, il comportamento della camera e il cambiamento temporale previsto. La rotta unificata usa comunemente input_reference. Conferma regole correnti su dimensione file, formato e conteggio immagini prima della produzione.
curl https://api.cometapi.com/v1/videos \ -H "Authorization: Bearer $COMETAPI_KEY" \ -F "model=wan2.7" \ -F "prompt=The camera slowly pushes forward while the subject turns toward the warm window light; preserve identity, clothing and background composition." \ -F "input_reference=@reference.png" \ -F "seconds=5" \ -F "size=1280x720"
Suggerimento per il prompt immagine: non usare la maggior parte del prompt per ridiscrivere contenuti statici già visibili nel riferimento. Usa il budget del prompt per movimento, direzione della camera, tempistica, cambiamenti e vincoli.
Passo 5: costruisci il workflow Python completo
Il seguente programma valida la chiave API, invia un’attività, normalizza risposte di stato incapsulate, applica un’attesa massima, gestisce i fallimenti terminali e scarica il file completato.
import os import time from pathlib import Path import requests API_KEY = os.environ.get("COMETAPI_KEY") BASE_URL = "https://api.cometapi.com/v1" POLL_INTERVAL = 12 MAX_WAIT_SECONDS = 900 if not API_KEY: raise RuntimeError("Set COMETAPI_KEY before running this script.") headers = {"Authorization": f"Bearer {API_KEY}"} def parse_task_data(payload): return payload.get("data") or payload # 1. Submit the generation task. submit = requests.post( f"{BASE_URL}/videos", headers=headers, files={ "model": (None, "wan2.7"), "prompt": ( None, "A cinematic tracking shot of a futuristic train " "crossing a snowy mountain valley at sunrise." ), "seconds": (None, "5"), "size": (None, "1280x720"), }, timeout=60, ) submit.raise_for_status() submit_payload = submit.json() video_id = submit_payload.get("id") or submit_payload.get("task_id") if not video_id: raise RuntimeError(f"No video ID in response: {submit_payload}") print(f"Created video task: {video_id}") # 2. Poll until a terminal state or timeout. deadline = time.monotonic() + MAX_WAIT_SECONDS while time.monotonic() < deadline: response = requests.get( f"{BASE_URL}/videos/{video_id}", headers=headers, timeout=30, ) response.raise_for_status() payload = response.json() data = parse_task_data(payload) status = str(data.get("status", "unknown")) progress = data.get("progress", "unknown") print(f"status={status}, progress={progress}") if status in {"completed", "success"} or progress in {100, "100", "100%"}: break if status in {"failed", "error", "FAILURE"}: raise RuntimeError(f"Video generation failed: {payload}") time.sleep(POLL_INTERVAL) else: raise TimeoutError(f"Task {video_id} exceeded {MAX_WAIT_SECONDS}s") # 3. Download the completed MP4. video = requests.get( f"{BASE_URL}/videos/{video_id}/content", headers=headers, timeout=180, ) video.raise_for_status() output = Path("output") / f"{video_id}.mp4" output.parent.mkdir(parents=True, exist_ok=True) output.write_bytes(video.content) if output.stat().st_size == 0: raise RuntimeError("Downloaded file is empty.") print(f"Saved {output} ({output.stat().st_size} bytes)")
Passo 6: chiama Wan 2.7 con JavaScript
Questo esempio Node.js usa fetch e FormData integrati. Usa Node.js 18 o successivo; l’esempio scrive il risultato con node:fs/promises.
import { mkdir, writeFile } from "node:fs/promises"; const apiKey = process.env.COMETAPI_KEY; const baseUrl = "https://api.cometapi.com/v1"; const pollIntervalMs = 12_000; const maxWaitMs = 15 * 60 * 1000; if (!apiKey) throw new Error("Set COMETAPI_KEY first."); const headers = { Authorization: `Bearer ${apiKey}` }; const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms)); const form = new FormData(); form.append("model", "wan2.7"); form.append( "prompt", "A cinematic tracking shot of a futuristic train crossing " + "a snowy mountain valley at sunrise." ); form.append("seconds", "5"); form.append("size", "1280x720"); const submitResponse = await fetch(`${baseUrl}/videos`, { method: "POST", headers, body: form, }); if (!submitResponse.ok) throw new Error(await submitResponse.text()); const submitPayload = await submitResponse.json(); const videoId = submitPayload.id || submitPayload.task_id; if (!videoId) throw new Error(`No video ID: ${JSON.stringify(submitPayload)}`); const deadline = Date.now() + maxWaitMs; while (Date.now() < deadline) { const statusResponse = await fetch(`${baseUrl}/videos/${videoId}`, { headers }); if (!statusResponse.ok) throw new Error(await statusResponse.text()); const payload = await statusResponse.json(); const data = payload.data || payload; const status = String(data.status || "unknown"); const progress = data.progress ?? "unknown"; console.log({ status, progress }); if (["completed", "success"].includes(status) || [100, "100", "100%"].includes(progress)) { break; } if (["failed", "error", "FAILURE"].includes(status)) { throw new Error(`Generation failed: ${JSON.stringify(payload)}`); } await sleep(pollIntervalMs); } if (Date.now() >= deadline) throw new Error(`Task ${videoId} timed out.`); const videoResponse = await fetch(`${baseUrl}/videos/${videoId}/content`, { headers }); if (!videoResponse.ok) throw new Error(await videoResponse.text()); await mkdir("output", { recursive: true }); const outputPath = `output/${videoId}.mp4`; await writeFile(outputPath, Buffer.from(await videoResponse.arrayBuffer())); console.log(`Saved ${outputPath}`);
Quali sono i parametri dell’API Wan 2.7?
| Parametro | Tipo | Obbligatorio | Esempio | Scopo |
|---|---|---|---|---|
| model | string | Sì | wan2.7 | Seleziona la rotta |
| prompt | string | Sì | Descrizione scena | Definisce contenuto, movimento e stile |
| seconds | integer | No | 5 | Controlla durata e costo |
| size | string | No | 1280x720 | Controlla risoluzione/rapporto |
| input_reference | file | I2V | reference.png | Fornisce un’immagine sorgente |
| Authorization | header | Sì | Bearer token | Autentica la richiesta |
Mappatura parametri CometAPI e nativi Alibaba
| Concetto | CometAPI | API nativa Alibaba |
|---|---|---|
| Modello | wan2.7 | wan2.7-t2v o wan2.7-i2v-* |
| Durata | seconds | duration |
| Risoluzione | size | resolution più ratio |
| Immagine di riferimento | input_reference | media[].type=first_frame |
| Identificatore task | id o task_id | output.task_id |
| Stato task | GET /v1/videos/{id} | Endpoint di query del provider |
| Risultato binario | GET /v1/videos/{id}/content | URL temporaneo del risultato / risposta provider |
Questa mappatura spiega perché esempi copiati da Alibaba Cloud non possono essere incollati inalterati su CometAPI. La capacità del modello è correlata, ma il livello di accesso e lo schema sono diversi.
Come scrivere prompt migliori per Wan 2.7: esempi
Un prompt video pratico definisce cosa dovrebbe rimanere stabile e cosa dovrebbe cambiare nel tempo. Usa questa struttura:
Subject + action + environment + camera movement + lighting + visual style + timeline + audio direction + constraints
Prompt a singola inquadratura
A red vintage roadster drives along a wet coastal highway at blue hour. The camera tracks low beside the front wheel, then rises smoothly to reveal ocean cliffs. Realistic reflections, restrained motion blur, cinematic 35mm look, no text or logos.
Prompt multi‑shot
Create a cinematic detective sequence with consistent character identity. Shot 1 [0-2s]: a rain-soaked city street at night, neon reflected in puddles. Shot 2 [2-4s]: the detective enters an old building; slow handheld follow shot. Shot 3 [4-5s]: close-up of a clue under a narrow flashlight beam. Preserve the same coat, face and lighting palette across all shots. No captions.
Prompt da immagine a video
Preserve the subject's face, clothing and background layout. The subject looks up, turns slightly toward the window and takes one step forward. Slow camera push-in, warm light gradually increases, natural hair and fabric motion, no new objects.
Indicazioni sui prompt negativi
Usa i prompt negativi per sopprimere i failure ricorrenti anziché per descrivere una seconda volta la scena desiderata. Un elenco conciso come low resolution, deformed hands, duplicated limbs, flicker, unstable face, unreadable text e watermark è di solito più utile di un lungo paragrafo contraddittorio.
Quanto costa l’API Wan 2.7?
L’attuale rotta CometAPI elenca Wan 2.7 a $0,08 al secondo per 720p e $0,12 al secondo per 1080p. Il costo stimato è quindi una funzione diretta della durata generata e della risoluzione selezionata.
| Risoluzione | Prezzo / secondo | 5 secondi | 10 secondi | 15 secondi |
|---|---|---|---|---|
| 720p | $0.08 | $0.40 | $0.80 | $1.20 |
| 1080p | $0.12 | $0.60 | $1.20 | $1.80 |
Estimated video cost = price per second x generated duration in seconds
(Fonte dati: prezzi live del modello su CometAPI.)
Interpretazione dei prezzi: non affermare che una rotta di aggregatore sia più economica di Alibaba Cloud senza confrontare stessa regione, variante di modello, risoluzione, durata, modalità audio e unità di fatturazione. Il prezzo per secondo chiaro di CometAPI e la fatturazione unificata sono vantaggi di integrazione; un vantaggio di prezzo lato provider richiede un confronto su base equa.
Una clip 1080p che fallisce la revisione creativa è più costosa del prezzo di generazione indicato perché il team deve rigenerarla. Per la pianificazione di produzione, dividi la spesa totale per il numero di clip accettate senza rifacimenti.
Wan 2.7 vs Seedance 2.5 vs Vidu Q3 vs Veo 3.1
Le alternative più utili sulla stessa piattaforma sono Seedance 2.5, Vidu Q3 e Veo 3.1. La tabella seguente confronta l’aderenza al flusso di lavoro anziché dichiarare un vincitore universale. Le funzionalità della rotta possono cambiare, quindi verifica gli input avanzati prima della produzione.
| Dimensione | Wan 2.7 | Seedance 2.5 | Vidu Q3 | Veo 3.1 |
|---|---|---|---|---|
| Posizionamento principale | Suite multimodale controllabile | Narrazione più lunga e generazione ricca di riferimenti | Creazione rapida orientata alla storia | Video cinematografici con audio nativo |
| Testo‑video | Sì | Sì | Sì | Sì |
| Immagine‑video | Sì | Sì | Sì | Sì |
| Controllo primo/ultimo frame | Supporto nativo di famiglia | Dipende dalla rotta | Supportato | Supportato in flussi selezionati |
| Continuazione video | Supporto nativo di famiglia | Orientato all’editing | Dipende dalla rotta | Flussi di estensione |
| Audio | Guida in input + BGM/SFX automatici | Audio‑video congiunti | Audio sincronizzato nativo | Audio sincronizzato nativo |
| Durata comune della rotta | 2‑15 s T2V nativo | 4‑30 s rotta elencata | 1‑16 s rotta elencata | 4/6/8 s modalità ufficiali |
| Risoluzione massima comune | 1080p | Dipende dalla rotta | 1080p | 1080p; altre varianti possono differire |
| Miglior adattamento | Flussi di produzione controllati | Storytelling multi‑shot più lungo | Iterazione narrativa rapida | Riprese cinematiche di alto livello |
Risultati del confronto
- Scegli Wan 2.7 quando controllo primo/ultimo fotogramma, continuazione, guida audio e un ampio flusso controllabile contano più della lunghezza massima della singola clip.
- Scegli Seedance 2.5 quando priorità sono storytelling multi‑shot più lungo e lavoro creativo ricco di riferimenti.
- Scegli Vidu Q3 quando al centro ci sono iterazione narrativa rapida, audio sincronizzato e flussi orientati ai creator.
- Scegli Veo 3.1 quando qualità cinematografica, realismo visivo e audio integrato valgono un costo di rotta più alto.
- Non scegliere un vincitore solo sulle specifiche. Usa un set fisso di prompt e asset, quindi confronta il tasso di output accettati e il costo totale di produzione.
Best practice per la produzione
Ciclo di vita dei task e affidabilità
- Conserva l’ID del task immediatamente dopo la creazione.
- Usa una strategia di idempotenza nella tua applicazione, così un retry del client non crea attività duplicate a pagamento.
- Esegui polling con intervallo di 10‑15 secondi e attesa massima, invece di un loop illimitato.
- Differenzia i fallimenti HTTP transitori dai fallimenti di generazione dichiarati dal provider.
- Usa backoff esponenziale per errori di rete o di limite di frequenza, ma non riprovare ciecamente per fallimenti di policy sui contenuti.
- Segna un job come completato solo dopo che l’output è stato scaricato e validato come non vuoto.
- Non dipendere permanentemente da un URL temporaneo del provider; copia gli output accettati in uno storage sotto il tuo controllo dove consentito.
Qualità e controllo dei costi
- Prototipa i prompt in 720p e con durate brevi prima di generare master in 1080p.
- Mantieni insieme prompt, prompt negativo, ID modello, rotta, risoluzione, durata, ID task e hash dell’output per la riproducibilità.
- Crea una rubrica di revisione per aderenza al prompt, movimento, coerenza temporale, identità, mani, artefatti nel testo, audio e sicurezza.
- Misura il costo per output accettato, non solo il costo per richiesta.
- Mantieni un piccolo set di prompt di regressione e rieseguilo prima di cambiare versioni della rotta o provider di modello.
Sicurezza e governance
- Tieni le chiavi API lato server e ruotale quando sospetti un’esposizione.
- Valida upload di immagini e video prima di inoltrarli alla rotta di generazione.
- Applica controlli su consenso, somiglianza e proprietà intellettuale per media di riferimento.
- Aggiungi revisione umana per pubblicità, news, politica, ambiti medici o altri usi ad alto impatto.
- Conserva metadati di provenienza e applica politiche di filigrana o disclosure richieste dalla tua giurisdizione e piattaforma.
Errori comuni e troubleshooting
| Errore o sintomo | Causa probabile | Correzione raccomandata |
|---|---|---|
| 401 Unauthorized | Chiave mancante, non valida o revocata | Controlla il token Bearer e la variabile d’ambiente |
| 400 Bad Request | Campo, dimensione o durata non supportati | Parti dall’esempio della pagina del modello e aggiungi campi gradualmente |
| Nessun task ID | Wrapper di risposta inaspettato | Registra la risposta completa e verifica data, id e task_id |
| In coda a lungo | Carico o capacità del provider | Continua il polling con limiti; non duplicare il task |
| Generazione fallita | Errore media, prompt, policy o provider | Ispeziona il payload terminale prima di decidere se riprovare |
| MP4 vuoto | Download prima del completamento o body di errore salvato | Controlla lo stato e il Content‑Type prima di scrivere il file |
| Riferimento rifiutato | Formato, dimensioni, grandezza o conteggio | Converti in PNG/JPEG e segui i limiti della rotta live |
| Costo inatteso | Durata lunga, alta risoluzione o retry | Prototipa in 720p e traccia il tasso di output accettati |
| Risultato incoerente | Generazione stocastica o prompt di movimento vago | Specifica tempistica e vincoli; confronta più candidati |
Raccomandazione finale
Il valore pratico di Wan 2.7 è l’ampiezza del suo flusso video controllabile: testo‑video, animazione da immagine, fotogrammi ancorati, continuazione, generazione guidata da riferimenti e comportamento consapevole dell’audio. Tramite CometAPI, il percorso più rapido è validare una richiesta di 5 secondi in 720p con l’endpoint asincrono unificato, quindi aggiungere input immagine e output 1080p dopo che creazione attività, polling e download sono affidabili.
Per la produzione, mantieni le funzionalità native avanzate dietro controlli di compatibilità espliciti perché lo schema unificato di CometAPI potrebbe non esporre ogni campo di Alibaba. Confronta Wan 2.7 con alternative usando gli stessi prompt e asset e seleziona la rotta che produce il costo più basso per video approvato, non il prezzo nominale più basso.
Domande frequenti (FAQ)
Che cos’è l’API Wan 2.7?
È una famiglia multimodale di generazione video accessibile via API che copre testo‑video, immagine‑video, flussi guidati da riferimenti ed editing video. CometAPI espone la rotta cliente tramite l’ID modello wan2.7.
Qual è l’ID modello Wan 2.7 su CometAPI?
Usa wan2.7. Non sostituirlo con identificatori nativi Alibaba come wan2.7-t2v a meno che tu non stia chiamando direttamente Alibaba Cloud.
Quale endpoint crea un video Wan 2.7?
Invia una richiesta multipart POST a https://api.cometapi.com/v1/videos. Quindi interroga /v1/videos/{video_id} e scarica da /v1/videos/{video_id}/content.
Wan 2.7 supporta testo‑video e immagine‑video?
Sì. Entrambe sono funzionalità elencate. L’immagine‑video aggiunge un’immagine di riferimento e dovrebbe usare i requisiti correnti del campo multipart della rotta.
Quali risoluzioni supporta Wan 2.7?
La rotta video pubblicata di Wan 2.7 supporta 720p e 1080p. La documentazione nativa testo‑video elenca anche dimensioni di output specifiche per rapporto per entrambi i livelli.
Quanto può durare un video Wan 2.7?
L’API nativa testo‑video di Wan 2.7 di Alibaba consente durate intere da 2 a 15 secondi con predefinito a 5 secondi. Usa i valori documentati per la specifica rotta CometAPI che chiami.
Wan 2.7 genera audio?
Alibaba documenta la generazione guidata dall’audio e la musica di sottofondo o gli effetti sonori automatici quando l’audio viene omesso. I campi audio esatti esposti tramite una rotta unificata vanno verificati prima della produzione.
Wan 2.7 può usare primo e ultimo fotogramma?
La famiglia nativa immagine‑video supporta flussi di lavoro con primo fotogramma e primo+ultimo fotogramma. Conferma i campi corrispondenti nella rotta unificata prima di farvi affidamento su CometAPI.
L’API Wan 2.7 è sincrona o asincrona?
È asincrona. La creazione dell’attività restituisce un ID; la tua applicazione deve fare polling dello stato e scaricare il risultato dopo il completamento.
Quanto costa Wan 2.7 su CometAPI?
La rotta pubblicata indica $0,08 al secondo per 720p e $0,12 al secondo per 1080p. Una clip di 5 secondi costa quindi rispettivamente $0,40 o $0,60.
Dovrei usare Wan 2.7, Seedance 2.5, Vidu Q3 o Veo 3.1?
Usa Wan 2.7 per ampia controllabilità, Seedance 2.5 per storytelling più lungo ricco di riferimenti, Vidu Q3 per iterazione narrativa rapida e audio sincronizzato, e Veo 3.1 per output cinematografici premium. Valida la scelta con un A/B test controllato.
Wan 2.7 può continuare un video esistente?
Sì nella famiglia di modelli nativa tramite un flusso first_clip. Disponibilità e mappatura dei parametri sulla rotta unificata di CometAPI devono essere verificate.
