Tutorial API Wan 3.0 Prime in cinese: testo, primo/ultimo frame e video da riferimento

TL;DR

• Wan 3.0 Prime (versione accelerata di Wan 3.0) è la linea rapida di Wan 3.0 di Alibaba, nome del modello wan3.0-video-prime. Un solo modello basta per video da testo, video da primo/ultimo frame e video da riferimento; i materiali di riferimento possono essere immagini, audio, persino un documento o una pagina web. Clip da 2–30 secondi, con audio predefinito. Apri la pagina del modello per generare online.
• Fatturazione al secondo: 480P $0,0875 al secondo, 720P $0,18, 1080P $0,36. 5 secondi a 480P costano solo $0,4375.
• Due trappole: la risoluzione va scritta in maiuscolo 480P / 720P / 1080P, e il valore predefinito è 1080P; Prime non accetta video di riferimento.

Guarda prima il risultato

Video da testo, 480P, 5 secondi, con audio (attivando l'audio si sentono pioggia, traffico e il sfrigolio della griglia):

Rain streaking down a narrow neon-lit alley at night; a slow dolly-forward past
steaming street-food stalls, magenta and cyan reflections rippling in the wet
pavement, a tabby cat darting between crates mid-shot. Ambient sound: steady
rain, distant traffic hiss, the sizzle of a grill and a low synth drone.

Genera con questo prompt → (5 secondi, 480P, 16:9, audio attivo)

wan3.0-video-prime, 480P, 5 secondi, con audio, $0,4375.

Video da riferimento: invia l'immagine di una statuetta di volpe in ceramica e falla muovere mantenendo l'aspetto invariato.

Bring the referenced ceramic fox figurine to life: it slowly turns its head
toward camera, blinks, and tilts with a curious expression; subtle idle
breathing, a light breeze stirring the tiny scarf, soft studio key light on a
clean seamless backdrop, smooth loopable motion.

Genera con questo prompt → (carica la tua immagine di riferimento, 5 secondi, 480P, 9:16)

wan3.0-video-prime, immagine di riferimento, 480P, 5 secondi, 9:16, $0,4375.

curl: il primo video

5 secondi a 480P, $0,4375:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "input": {
      "prompt": "一只橘猫趴在洒满阳光的窗台上打哈欠，尾巴轻轻摆动，镜头缓慢推近，暖色调",
      "resolution": "480P",
      "duration": 5,
      "aspect_ratio": "16:9",
      "audio": false
    }
  }'

Dopo aver ricevuto data.taskId, usa GET /v1/tasks/{taskId} per verificare che status sia success, poi scarica output[0].url.

Python: invio, polling, download

# pip install requests；先 export HIAPI_KEY=你的 Key
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(timeout_s=900, **inp):
    # 重试提交同一个任务时带同一个 Idempotency-Key，避免重复扣费
    r = requests.post(API, json={"model": "wan3.0-video-prime", "input": inp},
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# 参考生视频：让参考图里的产品动起来，480P 5 秒（$0.4375）
url = generate(
    prompt="让参考图里的香水瓶在黑色大理石上缓慢旋转，侧逆光扫过瓶身，镜头缓慢推近",
    reference_image_urls=["https://your-cdn.example.com/perfume.jpg"],
    resolution="480P", duration=5, aspect_ratio="9:16", audio=False,
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Tre modalità d'uso

Modalità	Cosa inviare	Note
Video da testo	Solo prompt
Primo/ultimo frame	first_frame_url, eventualmente più last_frame_url	Non utilizzabile insieme ai materiali di riferimento
Video da riferimento	reference_image_urls (fino a 10 immagini), reference_audio_urls (fino a 5 tracce, da usare insieme alle immagini), reference_file_urls o reference_link_urls (fino a 1 ciascuno, in alternativa)	Nel prompt si fa riferimento ai materiali in ordine con Image1, Audio1

Documenti e pagine web di riferimento sono la particolarità di Wan 3.0: puoi affidare al modello un PDF di linee guida del brand o il link a una pagina prodotto e fargli creare il video in base alle informazioni contenute. La pagina web deve essere apribile senza login.

Panoramica dei parametri

Parametro	Valori	Note
prompt	Stringa, obbligatorio	Descrivi scena, azione, inquadratura, luce e audio
resolution	480P / 720P / 1080P, predefinito 1080P	Maiuscolo, determina direttamente il prezzo
duration	Intero da 2 a 30, predefinito 5	In secondi
aspect_ratio	adaptive 16:9 4:3 1:1 3:4 9:16, predefinito adaptive	adaptive sceglie automaticamente in base ai materiali e al prompt
audio	Predefinito true	Traccia audio sincronizzata, senza costi aggiuntivi
seed	0–2147483647	Seed fisso per facilitare la riproduzione
first_frame_url / last_frame_url	URL dell'immagine	Primo/ultimo frame
reference_image_urls ecc.	Vedi tabella sopra	Video da riferimento

Calcolo dei costi

Durata	480P ($0,0875/sec)	720P ($0,18/sec)	1080P ($0,36/sec)
5 secondi	$0,4375	$0,90	$1,80
10 secondi	$0,875	$1,80	$3,60
30 secondi	$2,625	$5,40	$10,80

Inizia a 480P per mettere a punto il prompt, poi passa a 720P o 1080P una volta definito. Se non hai fretta, la versione standard di Wan 3.0 (wan3.0-video) a 720P costa solo $0,08 al secondo e accetta anche video di riferimento. Per il listino completo vedi Prezzi API Wan 3.0 Prime.

Da tenere presente prima di andare in produzione

• Usa i callback invece del polling: al livello superiore della richiesta (allo stesso livello di input) aggiungi "callback": {"url": "https://tuodominio/hiapi/callback"} e deduplica per taskId.
• Salva subito: output[0].url è un link temporaneo.
• Riprova con la chiave di idempotenza: aggiungi Idempotency-Key nell'header della richiesta; riprovando con la stessa chiave il task viene creato una sola volta.
• Rimborso automatico in caso di errore: si paga solo per i video generati con successo.

Domande frequenti

Perché inviando 720p ricevo un errore?

La risoluzione va scritta in maiuscolo. In minuscolo restituisce 400: resolution: value must be one of '480P', '720P', '1080P'.

Posso inviare un video di riferimento?

Prime no, non accetta il parametro reference_video_urls. Per i video di riferimento passa alla versione standard di Wan 3.0 wan3.0-video.

Si può disattivare l'audio?

Sì, audio: false. È attivo per impostazione predefinita e il prezzo non cambia.

Qual è la differenza tra Prime e la versione standard di Wan 3.0?

Parametri e specifiche di output sono identici; Prime è la linea accelerata. La versione standard ha anche il livello 480P ($0,04/sec), ma 720P e 1080P costano più del doppio al secondo e non accetta video di riferimento.

Per altri esempi di prompt vedi Esempi di prompt per Wan 3.0 Prime, per il confronto con la generazione precedente vedi Come scegliere tra Wan 3.0 e Wan 2.7. Puoi anche andare direttamente alla pagina del modello per generare il vicolo sotto la pioggia.