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
- 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:
480poppure720p, predefinito480p. - 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) oppuremov. - 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
- 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_urlsenza il primo frame. - 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.
- Proporzioni diverse dalle attese: questa linea usa sempre
adaptivee l'output segue il primo frame; se si desidera 16:9 o 9:16 bisogna impostarlo sul primo frame. - 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.
- 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.
Articoli correlati
Vedi tutti gli articoli →-
Guida all'uso
Guida all'integrazione di Seedance 2.5 Flash per la generazione video da materiali di riferimento: immagini di riferimento, audio di riferimento e regole di fatturazione
-
Guida all'uso
Guida all'integrazione di Seedance 2.5 Flash text-to-video: parametri, tariffazione al secondo e pratica ingegneristica
Da una richiesta alla messa in produzione stabile: come impostare i parametri e come calcolare i costi
-
Guida all'uso
Guida introduttiva a kling-image-4.0: punti chiave per l'integrazione dell'API di generazione immagini e controllo dei costi
Decisioni di integrazione e checklist operativa per gli sviluppatori