Seedance 2.0@ext video brevi: un flusso di lavoro API pratico per i video social

Oggi la maggior parte dei contenuti social viene scoperta tramite video brevi, e un video verticale curato di solito significa dover girare, montare, o entrambe le cose. seedance-2.0@ext su hiapi salta questi passaggi: scrivi un prompt dettagliato, chiami un endpoint API e in pochi minuti ricevi un video 9:16 finito, con tanto di audio.

Questa guida pratica usa un video breve realmente generato per spiegare l'intero flusso di lavoro dall'inizio alla fine: come è strutturato il prompt, come si usa concretamente l'API asincrona dei task, quanto è costato e dove il prezzo smette di corrispondere alle tue aspettative.

Perché scegliere seedance-2.0@ext per i video brevi

seedance-2.0@ext è la route ext della famiglia di modelli seedance-2.0 su hiapi: una route separata, con prezzi e set di parametri propri, diversa dalla route predefinita seedance-2.0. È pensata per output verticali e nativi per i social: inquadratura nativa 9:16, movimenti di camera che funzionano bene sullo schermo del telefono e audio prodotto nella stessa generazione del video, anziché aggiunto in un secondo momento.

Questa combinazione, inquadratura verticale più audio nativo, è ciò che la rende adatta a video brevi in stile TikTok e Reels, invece di usare un modello video generico e poi ritagliare e aggiungere musica da soli.

Il prompt: cosa è stato effettivamente usato per questo video

Per questo articolo abbiamo generato end-to-end un video dimostrativo: un primo piano verticale di prodotto con un caffè cold brew versato in un bicchiere pieno di ghiaccio, con uno stile pensato per il feed social. Ecco l'output reale e il prompt originale che lo ha generato.

Presentazione verticale 9:16 di un prodotto in primo piano per il feed social: un bicchiere di vetro smerigliato al centro di un piano di marmo illuminato dal sole. La camera si avvicina lentamente dall'alto verso il bicchiere vuoto, che si riempie di cubetti di ghiaccio trasparenti che riflettono la luce dell'ora d'oro. Al secondo 2, un flusso di caffè cold brew viene versato dall'alto fuori campo, vortica e scurisce il ghiaccio, poi il latte si insinua con delicate volute a spirale. Gocce d'acqua scivolano lungo il vetro, mentre il vapore freddo sale in controluce. La camera si muove lentamente con un arco da un'inquadratura dall'alto a un'angolazione bassa a tre quarti, per chiudersi su un primo piano nitido con profondità di campo ridotta, con un caldo bokeh dalla finestra sullo sfondo. Illuminazione commerciale naturale e luminosa, riflessi lucidi, profondità di campo ridotta, estetica video di prodotto estremamente pulita, micro-movimenti fluidi a mano, finitura commerciale premium. Audio nativo: leggero gorgoglio del versamento, tintinnio del ghiaccio contro il vetro, leggero brusio ambientale di caffetteria, senza musica. Nessun testo leggibile, nessun logo, nessuna persona, nessuna mano, nessun montaggio.

Risultato: 720×1280 (9:16), 24fps, circa 8 secondi, con audio stereo AAC nativo integrato nel file: nessun processo di foley separato necessario.

Perché questo prompt funziona

Questo prompt fa diverse cose che prompt più brevi e vaghi non fanno:

• Dà alla camera un percorso, non una singola immagine. "Avvicinamento dall'alto" → "lento movimento ad arco verso un'angolazione bassa a tre quarti" → "primo piano nitido" descrive un movimento che attraversa l'intero video, non una composizione statica.
• Ancora l'azione nel tempo. "Al secondo 2, un flusso di caffè cold brew viene versato" fissa il versamento in un momento preciso, invece di lasciare che il modello indovini quando deve accadere "la parte interessante".
• Sovrappone indizi su materiali e luce. Gocce d'acqua, vapore freddo, bokeh caldo, riflessi lucidi: questi dettagli fanno passare una ripresa di prodotto dall'ordinario al premium.
• L'audio è scritto direttamente nel prompt, non aggiunto dopo: gorgoglio del versamento, tintinnio del ghiaccio, brusio ambientale, con l'esplicita richiesta di nessuna musica. Il modello sincronizza il suono con l'azione visiva descritta sopra.
• Si chiude con una lista di esclusioni. "Nessun testo leggibile, nessun logo, nessuna persona, nessuna mano, nessun montaggio" blocca in anticipo i modi più comuni di fallire nelle generazioni di prodotto.

Tratta il prompt come un breve brief creativo, non come una didascalia: è qui che sta la vera differenza nella qualità dell'output.

Riprodurlo con l'API /v1/tasks

seedance-2.0@ext funziona tramite l'endpoint asincrono dei task di hiapi. Invii un task, esegui il polling finché non è completo, poi estrai il video dalla risposta.

Invio:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0@ext",
    "input": {
      "prompt": "<your prompt>",
      "aspect_ratio": "9:16",
      "resolution": "720p",
      "duration": 8,
      "generate_audio": true
    }
  }'

prompt e aspect_ratio sono obbligatori: se ometti aspect_ratio, la chiamata fallisce la validazione prima ancora di arrivare alla generazione. resolution, duration (da 4 a 15 secondi) e generate_audio sono opzionali; i valori sopra sono vicini alla configurazione usata per generare il video di questo articolo.

Se arrivi dal mondo image-to-video, vale la pena ricordarlo: la pagina dei prezzi elenca una tariffa image-to-video per questo modello, ma lo schema di input effettivo accetta solo prompt testuali; i campi immagine o frame di riferimento vengono rifiutati. Qualunque cosa dica l'etichetta del prezzo, in pratica è un modello text-to-video.

Polling del risultato:

curl https://api.hiapi.ai/v1/tasks/<task_id> \
  -H "Authorization: Bearer $HIAPI_API_KEY"

Quando status riporta successo, output[0].url punta al file .mp4 finito. Il link è temporaneo, circa una settimana in base alla finestra di scadenza nella risposta del task, quindi scarica subito i byte e archiviali tu stesso, invece di collegarti direttamente a esso.

Prezzi: l'anomalia del 4K

seedance-2.0@ext viene fatturato al secondo di output, con tariffe che variano in base alla fascia di risoluzione:

Risoluzione	Prezzo al secondo
720p	$0.149
1080p	$0.373
2K	$0.662
4K	$0.467

Nota che su questo modello il 4K costa meno del 2K: $0.467/s contro $0.662/s. Non è un refuso né un pattern comune; la maggior parte dei modelli qui ha prezzi che salgono monotonicamente con la risoluzione. Non dare per scontato che valga anche per altri modelli e ricontrolla /api/pricing prima di inserire una logica di costo basata sulla risoluzione nella tua pipeline, perché queste fasce vengono effettivamente aggiornate.

Per riferimento, la generazione del video dimostrativo di 8 secondi a 720p sopra è costata $1.19: il semplice calcolo durata × tariffa al secondo per la fascia 720p.

Scegliere la risoluzione in base a dove verrà effettivamente pubblicato il video

Il solo salto da 720p a 1080p aumenta il costo di circa 2,5 volte, quindi prima di generare qualsiasi cosa in batch, la risoluzione è la leva da considerare per prima:

• Pubblicazione su feed e Stories (TikTok, Reels, Shorts): vengono quasi sempre guardati sul telefono, con una densità di pixel che è solo una frazione di quella reale del 1080p; il 720p lì di solito è indistinguibile ed è la fascia più economica.
• 1080p vale la pena quando il video può essere riutilizzato come hero image di una landing page o in campagne a pagamento che potrebbero essere renderizzate a dimensioni maggiori dello schermo di un telefono.
• 2K e 4K sono adatti a materiale di partenza che prevedi di ritagliare, ridimensionare o stabilizzare in post-produzione: la risoluzione extra ti dà spazio per ricomporre senza perdita visibile di qualità. Visto il listino sopra, su questo modello specifico il 4K è l'opzione più conveniente tra le due.

Domande frequenti

seedance-2.0@ext supporta image-to-video, non solo text-to-video? No: anche se la pagina dei prezzi elenca una tariffa image-to-video per questo modello, lo schema effettivo di /v1/tasks della route ext accetta solo prompt testuali; URL di immagini, frame di riferimento e video di riferimento vengono rifiutati. Finché l'elenco dei modelli della piattaforma non indica diversamente, consideralo solo text-to-video.

Posso controllare la durata del video generato? Sì, tramite il campo opzionale duration, con un valore intero da 4 a 15 secondi. Se lo ometti, il modello applica il valore predefinito; se un template a valle si aspetta una lunghezza specifica, è più sicuro impostarlo esplicitamente.

Il video include audio automaticamente? La generazione di audio nativo è disponibile tramite il campo opzionale generate_audio. Scrivi direttamente nel prompt l'audio che desideri, come il "leggero gorgoglio del versamento, tintinnio del ghiaccio contro il vetro, leggero brusio ambientale di caffetteria" di sopra: così verrà sincronizzato con l'azione visiva, senza bisogno di un flusso audio separato.

Il 4K costa davvero meno del 2K o è un bug di visualizzazione? Questo è il prezzo effettivo al momento della stesura (agosto 2026), non un bug; ma i prezzi per risoluzione possono cambiare, quindi prima di basarci un modello di costo, verifica su /api/pricing.

Per quanto tempo è valido l'URL del video restituito? L'output[0].url di un task completato è un link temporaneo, valido circa una settimana in base ai metadati di scadenza del task. Scarica e archivia il file tu stesso, invece di collegarti ad esso a lungo termine.

Cosa fare adesso

I dettagli completi dei parametri del modello e i prezzi attuali sono nella pagina del modello seedance-2.0@ext e nella pagina dei prezzi di hiapi. Per altri schemi di prompt intorno allo stesso modello, Seedance 2.0@ext: ricette di prompt contiene più esempi, mentre video di presentazione di prodotto brevi basati su Seedance 2.0 spiega come applicare lo stesso flusso di lavoro asincrono dei task a brief creativi diversi.