Come si usa l'API Wan 2.6 Flash Image to Video? Il formato segue l'immagine

TL;DR

• Wan 2.6 Flash Image to Video (wan2.6-flash/image-to-video) carica 1 immagine, scrivi una frase che descrive l'azione e genera un video di 5, 10 o 15 secondi in 720p / 1080p, con audio sincronizzato opzionale; il formato di output segue l'immagine di input, un'immagine verticale produce direttamente un video verticale. Apri la pagina del modello per provarlo subito; i nuovi utenti ricevono 200 crediti alla registrazione.
• Il prezzo è calcolato al secondo, con quattro combinazioni: 720p senza audio (predefinito) $0.029 al secondo, con audio $0.0575, 1080p senza audio $0.043, con audio $0.086 (prezzi completi nella pagina prezzi).
• La chiamata passa dall'interfaccia HiAPI /v1/tasks: image_urls deve contenere esattamente 1 immagine; in caso di successo, recupera l'URL del video da output (URL temporaneo, salvalo subito).

Cosa può fare

• Un'immagine + una frase = un'azione: il soggetto e la luce rimangono quelli dell'immagine originale; il modello aggiunge solo il movimento, la ripresa e l'atmosfera che richiedi.
• Tre durate: 5 / 10 / 15 secondi, predefinito 5 secondi.
• Il formato segue l'immagine: non esiste un parametro per il formato — un'immagine orizzontale produce 16:9, una verticale produce verticale, un'immagine 3:4 produce 3:4; i contenuti per i social non richiedono un secondo ritaglio.
• Audio su richiesta: audio è disattivato per impostazione predefinita; se attivato, l'audio viene generato in sincronia con le immagini (rumori ambientali come il suono di una spatola o del fuoco).

Qui sotto c'è un video reale (parametri predefiniti: 720p, 5 secondi, senza audio):

The fox turns its head toward the camera, its ears twitch, golden leaves drift down through the misty light

(In italiano: la volpe gira la testa verso la fotocamera, le orecchie fremono leggermente, foglie dorate cadono nella luce nebbiosa. Carica la foto della volpe come primo fotogramma; anche il prompt supporta l'italiano, massimo 1500 caratteri.)

·

wan2.6-flash/image-to-video, 720p, 5 secondi, 16:9, 1280×720, senza audio, $0.145.Guarda il video completo →

Genera con questo prompt →

Prezzi: quattro combinazioni in una tabella

Livello	Al secondo	5 secondi	10 secondi	15 secondi
720p senza audio (predefinito)	$0.029	$0.145	$0.29	$0.435
720P · con audio	$0.0575	$0.2875	$0.575	$0.8625
1080P · senza audio	$0.043	$0.215	$0.43	$0.645
1080P · con audio	$0.086	$0.43	$0.86	$1.29

Prezzo attuale HiAPI, verificato il 22 ottobre 2026. Prendendo come 1 il livello predefinito: con audio è circa 2 volte, passando a 1080p circa 1,5 volte, entrambi circa 3 volte. In caso di errore non viene addebitato nulla.

Due percorsi per iniziare

Browser in 3 passi: apri la pagina del modello → carica l'immagine, scrivi la descrizione dell'azione → fai clic su Genera; con il livello predefinito sono 5 secondi a $0.145. Dopo la generazione puoi visualizzare l'anteprima direttamente nella pagina e, quando sei soddisfatto, scrivere il codice per integrare l'interfaccia nei tuoi processi aziendali.

API in 3 passi: POST /v1/tasks per inviare → ottieni taskId → GET /v1/tasks/<taskId> per verificare success e poi scaricare.

curl: il primo comando

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: your-unique-key-001" \
  -d '{
  "model": "wan2.6-flash/image-to-video",
  "input": {
    "prompt": "The fox turns its head toward the camera, its ears twitch, golden leaves drift down through the misty light",
    "image_urls": ["https://static.hiapi.ai/gallery/2026/10/ced2dd4214889094.jpg"],
    "duration": 5,
    "resolution": "720p",
    "audio": false
  }
}'

Questo comando, ai prezzi attuali, costa 720p senza audio × 5 secondi = $0.145.

Python: invio, polling, download

import time, uuid, requests

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

payload = {
    "model": "wan2.6-flash/image-to-video",
    "input": {
        "prompt": "The fox turns its head toward the camera, its ears twitch, golden leaves drift down through the misty light",
        "image_urls": ["https://example.com/your-image.jpg"],
        "duration": 5,
        "resolution": "720p",
        "audio": False,
    },
}

resp = requests.post(
    BASE,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json=payload,
    timeout=30,
)
resp.raise_for_status()
task_id = resp.json()["taskId"]

while True:
    task = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()
    print(task["status"])
    if task["status"] in ("success", "fail"):
        break
    time.sleep(5)

if task["status"] == "success":
    video = next(o for o in task["output"] if o.get("type") == "video")
    mp4 = requests.get(video["url"], timeout=120)   # indirizzo temporaneo, salva il prima possibile
    with open("output.mp4", "wb") as f:
        f.write(mp4.content)
    print("saved output.mp4")

Tabella dei parametri

Campo	Obbligatorio	Valori	Descrizione
image_urls	Sì	Esattamente 1	JPG / PNG / WebP, ≥256×256, ≤10MB; il formato determina il formato di output
prompt	Sì	1–1500 caratteri	Descrive azione, ripresa e atmosfera; italiano o inglese
duration	No	5 / 10 / 15, predefinito 5	Solo questi tre valori
resolution	No	720p / 1080p, predefinito 720p
audio	No	predefinito false	Audio sincronizzato, con tariffa separata (vedi tabella prezzi)

Se nel corpo della richiesta compaiono campi non presenti nella tabella, viene restituito direttamente 400.

Errori che potresti incontrare

Codice di stato	Significato	Come gestirlo
400 INVALID_REQUEST	Corpo della richiesta non valido (manca image_urls o prompt, sono state inviate 2 immagini, duration è 7)	Correggi il corpo della richiesta secondo la tabella dei parametri
402 INSUFFICIENT_QUOTA	Saldo insufficiente (nessun addebito)	Ricarica e riprova
429 RATE_LIMITED	Limite di frequenza raggiunto	Riduci la frequenza di invio
409 / 422 IDEMPOTENCY_KEY_*	Invio duplicato con la stessa chiave di idempotenza	Usa un nuovo Idempotency-Key

In caso di fallimento allo stato finale ci sono anche CONTENT_POLICY_VIOLATION, TASK_FAILED, TASK_TIMEOUT, ecc.; in caso di errore non viene addebitato nulla.

Da tenere presente prima della messa online

• Callback: passa "callback": {"url": "https://..."} al livello superiore del corpo della richiesta per ricevere automaticamente una notifica allo stato finale.
• Salva subito: l'URL del video in output è temporaneo; scaricalo appena lo ricevi.
• La qualità dell'immagine è il limite massimo: almeno 256×256, non più di 10MB; un'immagine grande e nitida produce un video nitido.
• Per materiali verticali carica un'immagine verticale: non esiste un parametro per il formato; se vuoi 9:16, carica un'immagine verticale.

Domande frequenti

Il formato segue l'immagine di input?

Sì. Immagine orizzontale → video orizzontale, immagine verticale → video verticale, immagine 3:4 → video 3:4 — non serve passare alcun parametro di proporzione.

Come si attiva l'audio?

Devi passare esplicitamente audio: true per avere l'audio; il prezzo viene calcolato secondo il livello Sound On (circa 2 volte).

Si può passare una durata arbitraria in secondi?

No. Sono disponibili solo 5 / 10 / 15 secondi; qualsiasi altro valore restituisce 400.

Il prompt può essere in italiano?

Sì. Italiano o inglese, massimo 1500 caratteri; descrivi azione e ripresa, senza ripetere la descrizione dell'immagine. La fatturazione dipende solo da risoluzione, durata e attivazione dell'audio.

Quanti video si possono generare con $10?

Con il livello predefinito (720p senza audio, 5 secondi) un video costa $0.145, quindi con $10 se ne ottengono circa 68.

Prossimo passo: prendi un'immagine del tuo prodotto o una foto e falla muovere nella pagina del modello; per quattro modelli di scenario consulta la raccolta di prompt.