Alibaba

Wan 2.7 Video

wan2.7-video/text-to-video

Modelli di generazione video della serie Alibaba WAN, supportano la generazione di video da testo, da immagine e guidata da riferimenti; input multipli di riferimento mantengono la coerenza di persone e prodotti tra diverse inquadrature

wan2.7-video/image-to-video wan2.7-video/text-to-video

Prova wan2.7-video/text-to-video

Input

Creazioni

Vedi tutte le creazioni

Output

video

Compila i parametri e genera: i risultati appariranno qui.

Prezzi

wan2.7-video/text-to-video per second

Specifiche	Prezzo unitario
720P	$0.100
1080P	$0.167

Panoramica della posizione

wan2.7-video/text-to-video è il modello di generazione video da testo della serie WAN video di Alibaba, richiamabile tramite l'interfaccia unificata di HiAPI.ai. Basta inserire un prompt testuale per generare una clip video con immagini e traccia audio opzionale, supporta cinque formati 16:9, 9:16, 1:1, 4:3 e 3:4, durata regolabile da 2 a 15 secondi, risoluzione selezionabile tra 720P e 1080P, e supporta prompt negativi, seed casuale e riscrittura del prompt. Adatto agli sviluppatori che necessitano di generare materiali video brevi guidati da solo testo, per la produzione di contenuti in batch e la previsualizzazione di storyboard creativi.

Punti di forza principali

Controllo programmabile dei parametri text-to-video——durata, formato, risoluzione e seed vengono passati come parametri dell'interfaccia, facilitando la generazione in batch tramite script e la riproduzione dei risultati.
Traccia audio opzionale e riscrittura del prompt——è possibile passare un URL audio wav/mp3 come traccia audio, e la riscrittura del prompt è attiva per impostazione predefinita per completare i dettagli dell'immagine.
Vincoli visivi tramite prompt negativi——supporta fino a 500 caratteri di prompt negativo, utile per escludere elementi indesiderati e ridurre il tasso di output non validi.

Descrizione delle capacità

Generazione di clip video tramite parametri: genera video combinando il prompt con durata (2–15 secondi), proporzioni del formato e livello di risoluzione; le specifiche di output sono determinate al momento della richiesta, riducendo ritagli e transcodifiche in post-produzione.

Riscrittura del prompt e vincoli negativi: prompt_extend è attivo per impostazione predefinita e può ampliare descrizioni brevi; negative_prompt viene passato separatamente per escludere contenuti specifici dell'immagine; l'uso combinato dei due migliora la controllabilità dell'output.

Riproduzione tramite seed e stabilità dei risultati: il parametro seed consente di riprodurre o ritoccare i risultati di generazione con lo stesso prompt, facilitando il confronto delle differenze tra diverse combinazioni di parametri.

Audio allegato e rimozione watermark: un URL audio opzionale funge da input per la traccia audio generata; l'interruttore watermark controlla se aggiungere il watermark di generazione AI, scegliendo il formato del prodotto finale in base alle esigenze.

Scenari applicativi

Team di contenuti per materiali video brevi in batch——generare in batch clip da 2–15 secondi con prompt scriptati, producendo materiali video brevi verticali/orizzontali pronti per la pubblicazione o per un secondo montaggio.
Storyboard creativi e previsualizzazione——generare rapidamente più versioni di immagini con lo stesso prompt e seed diversi, producendo materiali di previsualizzazione dinamici per il confronto di proposte e la conferma della progettazione delle inquadrature.
Video brevi per i social con musica——generare prodotti finiti con traccia audio combinando il prompt con un URL audio, producendo contenuti brevi pronti per la pubblicazione sulle piattaforme social.

Limiti e consigli per la scelta

La durata massima di una singola generazione è di 15 secondi; per video lunghi è necessario generare a segmenti e poi unirli, e la coerenza narrativa dipende dalla post-produzione. Attualmente è supportato solo il text-to-video; se è necessario vincolare la coerenza visiva tramite immagini o materiali di riferimento, occorre scegliere la linea image-to-video della stessa serie. La risoluzione massima è 1080P; per scenari che richiedono prodotti finiti ad alta risoluzione è necessario valutare soluzioni di upscaling in post-produzione. Il limite del prompt è di 5000 caratteri e quello del prompt negativo di 500 caratteri; gli script troppo lunghi devono essere suddivisi in più richieste.

Domande frequenti

Vedi tutte le domande →

Wan 2.7 Image to Video richiede il caricamento di un'immagine?

Sì. Attualmente wan2.7-video/image-to-video è un percorso image-to-video: l'immagine di input definisce il soggetto e la composizione iniziale, mentre il Prompt definisce i movimenti, la telecamera e i cambiamenti dell'ambiente.
Quali durate e risoluzioni supporta Wan 2.7 Image to Video?

L'attuale contratto di richiesta HiAPI supporta 2–15s, con risoluzioni di output 720P e 1080P. I valori disponibili sono quelli indicati nel pannello dei parametri della pagina e nella documentazione API.
Come viene fatturato Wan 2.7 Image to Video?

L'attività viene fatturata in base alla durata dell'output e al livello selezionato. La pagina mostra il prezzo in tempo reale seguendo l'unità monetaria globale; l'addebito finale fa fede al record dell'attività completata con successo.
Come migliorare la stabilità del soggetto nella generazione di video da immagine?

Usa un'immagine di input con soggetto nitido, poche occlusioni e composizione completa; nel Prompt descrivi prima l'azione principale e la telecamera, poi elenca gli elementi di aspetto, materiale e relazione con lo sfondo che devono essere preservati. Per il primo test si consiglia una durata breve.

Crea un'attività di generazione

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringObbligatorio

Chiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API

Content-TypestringOpzionale

Il corpo della richiesta viene sempre interpretato come JSON; se inviato, è accettato solo application/json (charset facoltativo) — qualsiasi altro valore restituisce 415. Esempio: application/json.

Idempotency-KeystringOpzionale

Chiave di idempotenza, fino a 255 byte. I retry con la stessa chiave dello stesso account creano l'attività una sola volta; i replay restituiscono il taskId originale.

Chiave di idempotenza

In caso di timeout di rete o retry automatici del client, la stessa chiave crea l'attività una sola volta, senza doppi addebiti (ambito = l'account della chiave API). Usa un identificatore univoco di business (es. "order-42"); i replay restituiscono il taskId originale e le chiavi scadono 24 ore dopo la prima richiesta. La matrice completa degli scenari è nell'introduzione dell'API asincrona unificata.

Corpo

modelstringObbligatorio

Valore fisso attuale: wan2.7-video/text-to-video

routestringOpzionale

Valore fisso attuale: default

inputobjectObbligatorio

Oggetto di parametri di business per wan2.7-video/text-to-video e la route default — vedi la tabella dei parametri sotto.

seedintegerOpzionalemin 0max 2147483647

Seme casuale, utilizzato per riprodurre o rifinire il risultato della generazione; accetta un numero intero, se non specificato viene generato casualmente dal sistema.

ratiostringOpzionalePredefinito: "16:9"

Proporzioni del video, espresse come stringa di rapporto; predefinito 16:9.

Opzioni:16:99:161:14:33:4

promptstringObbligatoriomaxLength 5000

Prompt testuale per la generazione del video, utilizzato per descrivere il contenuto visivo desiderato.

durationintegerOpzionalePredefinito: 5min 2max 15

Durata del video, in secondi; accetta un numero intero, predefinito 5.

audio_urlstringOpzionale

URL audio opzionale, supporta i formati wav/mp3, la durata deve essere compresa tra 2 e 30 secondi e la dimensione del file non deve superare 15MB.

watermarkbooleanOpzionalePredefinito: false

Indica se aggiungere una filigrana di generazione AI al video generato; accetta un valore booleano, predefinito false.

resolutionstringOpzionalePredefinito: "1080P"

Livello di risoluzione del video, il valore influisce sul prezzo calcolato al secondo; predefinito 1080P.

Opzioni:720P1080P

prompt_extendbooleanOpzionalePredefinito: true

Indica se abilitare la funzione di riscrittura (espansione) del prompt; accetta un valore booleano, predefinito true.

negative_promptstringOpzionalePredefinito: ""maxLength 500

Prompt negativo, utilizzato per escludere contenuti visivi indesiderati, massimo 500 caratteri; predefinito stringa vuota.

callbackobjectOpzionale

Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.

Callback (Webhook)

Fornisci callback.url in creazione e HiAPI invierà un POST al tuo servizio allo stato terminale, senza polling. Il corpo del callback replica la struttura del dettaglio attività; verifica firma, retry e idempotenza sono descritti nell'introduzione dell'API asincrona unificata.

urlstringObbligatorio

Obbligatoria se è presente callback. Allo stato terminale viene inviato un POST a questo URL; deve essere un URL http(s) valido.

whenstringOpzionalePredefinito: "final"

Al momento è supportato solo final: notifica sia su success sia su fail.

Opzioni:final

storagestringOpzionalePredefinito: "temp"

Livello di archiviazione degli artefatti: temp (predefinito, ~7 giorni) o persistent (a lungo termine, fatturato per dimensione). Saldo insufficiente o superamento del limite ⇒ declassamento silenzioso a temp; il livello effettivo è visibile nella risposta di dettaglio.

Opzioni:temppersistent

Esempi di richiesta

# Invia un'attività asincrona; restituisce subito un taskId (senza attendere la generazione)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan2.7-video/text-to-video",
  "input": {
    "ratio": "16:9",
    "prompt": "…",
    "duration": 5,
    "watermark": false,
    "resolution": "1080P",
    "prompt_extend": true,
    "negative_prompt": ""
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "wan2.7-video/text-to-video",
    input: {
      "ratio": "16:9",
      "prompt": "…",
      "duration": 5,
      "watermark": false,
      "resolution": "1080P",
      "prompt_extend": true,
      "negative_prompt": ""
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "wan2.7-video/text-to-video",
        "input": {
          "ratio": "16:9",
          "prompt": "…",
          "duration": 5,
          "watermark": False,
          "resolution": "1080P",
          "prompt_extend": True,
          "negative_prompt": ""
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Ottieni i dettagli dell'attività

GET https://api.hiapi.ai/v1/tasks/:id

Campi della risposta

taskIdstringObbligatorio

ID attività, sempre con prefisso tk-hiapi-.

modelstringObbligatorio

Nome completo risolto del modello. Le attività inviate con il parametro route restituiscono base@route (es. gpt-image-2/text-to-image@ext); altrimenti coincide con il nome inviato.

routestringOpzionale

Presente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.

statusstringObbligatorio

Stato dell'attività.

Valori di stato

queued In coda, non avviata. handling In elaborazione. archiving Elaborazione conclusa, preparazione artefatti. success Terminale: completato, artefatti disponibili (restituisce output). fail Terminale: errore (restituisce error). Dopo l'invio, segui status: success e fail sono terminali, il resto no. Esegui polling ogni 1–3 s fino allo stato terminale. In caso di successo scarica gli artefatti da output[].url e trasferiscili prima di expireAt; per conservazione lunga usa storage: "persistent" in creazione.

creatednumberObbligatorio

Istante di creazione dell'attività (secondi Unix).

completednumberObbligatorio

Secondi Unix dello stato terminale; 0 finché non terminale.

outputarrayOpzionale

Presente solo con status == success. Elenco artefatti — sempre un array; un'attività può restituire più type contemporaneamente (es. video + first_frame).

Array [ object ]

Elementi dell'array

urlstringObbligatorio

URL dell'artefatto, scaricabile direttamente.

typestringObbligatorio

Valori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.

expireAtnumberObbligatorio

Secondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.

errorobjectOpzionale

Presente solo con status == fail.

codestringObbligatorio

Codice errore di business.

messagestringObbligatorio

Descrizione dell'errore.

Esempi di risposta

Successo

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

In elaborazione (non terminale)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Non riuscito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}