MiniMax-M3.1-Flash and DeepSeek-V4.1-Flash-1017 are now live on CometAPI →
guide/Ricerca CometAPI

Come utilizzare Wan 2.7 API: guida completa per sviluppatori

Scopri come utilizzare l'API Wan 2.7 tramite CometAPI per la generazione da testo a video e da immagine a video, con esempi, tariffe, confronti e buone pratiche

CometAPI
Mia MarenTeam di ricerca su modelli AI e API
Aggiornato Sep 3, 2026 20 min di lettura
Come utilizzare Wan 2.7 API: guida completa per sviluppatori
Usa questo schema

Esegui la prima chiamata API.

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_COMETAPI_KEY",
    base_url="https://api.cometapi.com/v1",
)

response = client.chat.completions.create(
    model="gpt-5-mini",
    messages=[{"role": "user", "content": "Build this workflow."}],
)

print(response.choices[0].message.content)

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

SpecificaWan 2.7 Video
ProviderAlibaba / Wan
ID modello CometAPIwan2.7
ID nativi text‑to‑videowan2.7-t2v, wan2.7-t2v-2026-06-12
ID nativo image‑to‑videowan2.7-i2v-2026-04-25
Input principaliTesto; immagine, audio o video nei flussi supportati
Output principaleVideo generato con comportamento audio supportato
ModalitàT2V, I2V, R2V, video editing, primo/ultimo fotogramma, continuazione
Risoluzione720P e 1080P
Durata T2V2‑15 secondi; predefinito 5 secondi
Formati T2V16:9, 9:16, 1:1, 4:3, 3:4
Limite prompt5.000 caratteri per T2V nativo Wan 2.7
Limite prompt negativo500 caratteri
Formati e limiti audioWAV/MP3; 2‑30 secondi; fino a 15 MB
InvocazioneAsincrona
Architettura / numero di parametriNon 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.

EvidenzaRisultato pubblicoCome interpretarlo
Design Arena video‑to‑videoPrimo; Elo 1335 nell’immagine pubblicataForte evidenza di preferenza per V2V
Specifiche API ufficiali720P/1080P; 2‑15 secondi per T2VFlessibilità produttiva, non classifica di qualità
Punteggio T2V standardizzatoNon divulgato pubblicamenteUsare un A/B test interno
Punteggio I2V standardizzatoNon divulgato pubblicamenteUsare un A/B test interno
Latenza o tasso di successoNon standardizzati pubblicamenteMisurare 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

Come utilizzare Wan 2.7 API: guida completa per sviluppatori

(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?

ParametroTipoObbligatorioEsempioScopo
modelstringSìwan2.7Seleziona la rotta
promptstringSìDescrizione scenaDefinisce contenuto, movimento e stile
secondsintegerNo5Controlla durata e costo
sizestringNo1280x720Controlla risoluzione/rapporto
input_referencefileI2Vreference.pngFornisce un’immagine sorgente
AuthorizationheaderSìBearer tokenAutentica la richiesta

Mappatura parametri CometAPI e nativi Alibaba

ConcettoCometAPIAPI nativa Alibaba
Modellowan2.7wan2.7-t2v o wan2.7-i2v-*
Duratasecondsduration
Risoluzionesizeresolution più ratio
Immagine di riferimentoinput_referencemedia[].type=first_frame
Identificatore taskid o task_idoutput.task_id
Stato taskGET /v1/videos/{id}Endpoint di query del provider
Risultato binarioGET /v1/videos/{id}/contentURL 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.

RisoluzionePrezzo / secondo5 secondi10 secondi15 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.

DimensioneWan 2.7Seedance 2.5Vidu Q3Veo 3.1
Posizionamento principaleSuite multimodale controllabileNarrazione più lunga e generazione ricca di riferimentiCreazione rapida orientata alla storiaVideo cinematografici con audio nativo
Testo‑videoSìSìSìSì
Immagine‑videoSìSìSìSì
Controllo primo/ultimo frameSupporto nativo di famigliaDipende dalla rottaSupportatoSupportato in flussi selezionati
Continuazione videoSupporto nativo di famigliaOrientato all’editingDipende dalla rottaFlussi di estensione
AudioGuida in input + BGM/SFX automaticiAudio‑video congiuntiAudio sincronizzato nativoAudio sincronizzato nativo
Durata comune della rotta2‑15 s T2V nativo4‑30 s rotta elencata1‑16 s rotta elencata4/6/8 s modalità ufficiali
Risoluzione massima comune1080pDipende dalla rotta1080p1080p; altre varianti possono differire
Miglior adattamentoFlussi di produzione controllatiStorytelling multi‑shot più lungoIterazione narrativa rapidaRiprese 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 sintomoCausa probabileCorrezione raccomandata
401 UnauthorizedChiave mancante, non valida o revocataControlla il token Bearer e la variabile d’ambiente
400 Bad RequestCampo, dimensione o durata non supportatiParti dall’esempio della pagina del modello e aggiungi campi gradualmente
Nessun task IDWrapper di risposta inaspettatoRegistra la risposta completa e verifica data, id e task_id
In coda a lungoCarico o capacità del providerContinua il polling con limiti; non duplicare il task
Generazione fallitaErrore media, prompt, policy o providerIspeziona il payload terminale prima di decidere se riprovare
MP4 vuotoDownload prima del completamento o body di errore salvatoControlla lo stato e il Content‑Type prima di scrivere il file
Riferimento rifiutatoFormato, dimensioni, grandezza o conteggioConverti in PNG/JPEG e segui i limiti della rotta live
Costo inattesoDurata lunga, alta risoluzione o retryPrototipa in 720p e traccia il tasso di output accettati
Risultato incoerenteGenerazione stocastica o prompt di movimento vagoSpecifica 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.

Continua a imparare

Collega questo articolo alla prossima decisione.

Vedi tutti gli argomenti
Pubblicato il Aug 31, 2026
Ultimo aggiornamento Sep 3, 2026
19 visualizzazioni
Revisionato per chiarezza, attribuzione delle fonti e terminologia API aggiornata.

Leggi di più