HiAPI
Blog

Guida all'uso

Guida all'integrazione di Seedance 2.5 Flash per la generazione di video da immagini: primo frame, ultimo frame e fatturazione al secondo

Far muovere un'immagine: parametri, prezzi e cause comuni di errore

Nov 17, 2026
Una matrice discreta di punti verde menta su sfondo nero, con densità dei punti che aumenta gradualmente da sinistra verso destra.
Modello
seedance-2.5-flash
In questa pagina

Cosa fa questo modello

seedance-2.5-flash/image-to-video è il modello di generazione video da immagini di ByteDance: carichi un'immagine come primo frame, il modello la usa come punto di partenza per generare un video continuo e produce contemporaneamente l'audio. Le proporzioni dell'immagine seguono il primo frame, senza ritagli successivi.

È adatto a scenari che partono da materiale deterministico: presentazione dinamica di immagini di prodotto, microespressioni e movimenti del corpo di illustrazioni di personaggi, anteprime dinamiche di bozzetti di storyboard, cortometraggi da inserire in massa nei pool di contenuti. Non è adatto a esigenze in cui «basta una frase per generare una narrazione completa»: quello è il compito della linea text-to-video.

Parametri della richiesta

  • prompt (obbligatorio): descrive l'azione, il movimento di camera, la scena e l'audio desiderati, massimo 5000 caratteri.
  • first_frame_url (obbligatorio): immagine del primo frame. Supporta jpeg, png, webp, bmp, tiff, gif, heic, heif, massimo 30 MB per immagine, da 300 a 6000 pixel per lato, aspect ratio da 0.4 a 2.5.
  • last_frame_url (opzionale): immagine dell'ultimo frame, con gli stessi vincoli del primo frame; in caso di proporzioni non corrispondenti viene ritagliata al centro per l'allineamento. Se si passa l'ultimo frame è obbligatorio passare anche il primo frame.
  • resolution: 480p oppure 720p, predefinito 480p.
  • duration: numero intero da 4 a 30, predefinito 5, in secondi.
  • aspect_ratio: accetta solo adaptive, le proporzioni in output seguono l'immagine del primo frame.
  • output_format: mp4 (predefinito) oppure mov.
  • generate_audio: predefinito true.

Fatturazione al secondo

  • 480p: $0.0679/secondo
  • 720p: $0.1525/secondo

I secondi fatturati corrispondono alla duration richiesta. Le opzioni più comuni: 480p 4 secondi $0.2716, 720p 4 secondi $0.61, 480p 10 secondi $0.679, 720p 10 secondi $1.525. Le immagini del primo e dell'ultimo frame non hanno costi aggiuntivi.

Poiché la fatturazione è al secondo, ogni nuovo tentativo equivale a pagare di nuovo. Valutare «se il primo frame è adeguato» prima dell'invio costa molto meno che rigenerare dopo.

Il primo frame determina il limite massimo del risultato

Il modello può estendere solo le informazioni già presenti nel primo frame, quindi la qualità del primo frame determina quasi del tutto il limite massimo del risultato:

  • Soggetto nitido e con una proporzione ragionevole nell'inquadratura: se il soggetto è troppo piccolo, il modello fatica a capire cosa deve muoversi.
  • Evitare forti sfocature e rumore: un input di bassa qualità viene amplificato in ogni frame.
  • Attenzione ai bordi dell'immagine: i soggetti tagliati tendono a deformarsi durante il movimento.
  • Il testo nell'immagine difficilmente resta stabile in movimento, a meno che non sia volutamente secondario.
  • Preparare più primi frame candidati dello stesso soggetto è più efficace che modificare ripetutamente il prompt.

La durata è sia un costo sia una variabile di qualità

Più il clip è lungo, più frame il modello deve mantenere coerenti, e maggiore è la probabilità cumulativa di deriva e distorsione. Si consiglia di verificare prima con 4-5 secondi se il primo frame e la direzione del movimento funzionano, e solo dopo allungare secondo necessità; per contenuti lunghi è preferibile organizzare «più clip brevi + montaggio in post-produzione» anziché affidarsi a una singola generazione lunga.

Errori comuni e ordine di diagnostica

  1. Errore di parametri già all'invio: verificare prima se l'immagine supera i limiti (dimensione, lunghezza lato, aspect ratio, formato) e se è stato passato solo last_frame_url senza il primo frame.
  2. Deformazione del soggetto: il più delle volte il soggetto del primo frame è troppo piccolo, i bordi sono tagliati o l'ampiezza del movimento richiesta è eccessiva. Cambiare il primo frame o ridurre il movimento.
  3. Proporzioni diverse dalle attese: questa linea usa sempre adaptive e l'output segue il primo frame; se si desidera 16:9 o 9:16 bisogna impostarlo sul primo frame.
  4. Contenuto bloccato: anche il primo frame deve superare la verifica di conformità; ciò che è presente nell'immagine determina direttamente se la chiamata può essere accettata.
  5. Timeout del client ma attività in realtà riuscita: la generazione video richiede tempo; un timeout del client troppo breve fa passare un successo per un fallimento, e il reinvio comporta una nuova fatturazione. Gestire come attività asincrona e concedere un timeout sufficiente.

Consigli per la messa in produzione

Iniziare con tre-cinque primi frame di tipi diversi per verificare l'intero flusso, controllando che invio, polling e download funzionino; poi fissare il primo frame e modificare solo il prompt per capire quali descrizioni di azione il modello recepisce meglio; infine aumentare il volume in proporzione, monitorando tasso di successo, tempo medio di elaborazione e tasso di nuovi tentativi. Parametri e prezzi fanno fede alla descrizione corrente nella pagina del modello.

Inizia a creare con artefatti IA persistenti

Ottieni la tua chiave API e chiama modelli di immagini, video e audio tramite un'unica API basata sui task.

Leggi la documentazione API