HiAPI
Blog

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

Nov 17, 2026
Stacked sheets receding into shallow depth of field, cream and graphite with one terracotta sheet as accent.
Modello
seedance-2.5-flash
In questa pagina

Cosa fa questo modello

seedance-2.5-flash/reference-to-video è il modello video guidato da materiali di riferimento di ByteDance. Gli si forniscono immagini di riferimento e audio di riferimento, indicandoli nel prompt in ordine con @image1, @audio1, e il modello genera un nuovo video sulla base di questi. Le immagini di riferimento determinano l'aspetto di persone, prodotti o scene, mentre l'audio di riferimento fornisce il ritmo, la colonna sonora o la voce fuori campo.

Vincoli sui materiali di riferimento

  • Immagini di riferimento: massimo 10, formati supportati jpeg, png, webp, bmp, tiff, gif, ciascuna inferiore a 30 MB, lato singolo da 300 a 6000 pixel, rapporto d'aspetto da 0.4 a 2.5; SVG, HEIC e HEIF non sono supportati.
  • Audio di riferimento: massimo 5 segmenti, wav o mp3, inferiori a 15 MB, ciascun segmento da 2 a 30 secondi, totale non superiore a 30 secondi; è possibile fornire solo audio senza immagini.

È necessario fornire almeno una delle due categorie di materiali, altrimenti la richiesta non è valida.

Regole di fatturazione

Questa linea viene fatturata in base ai secondi del video di output; le immagini e gli audio di riferimento non vengono conteggiati nei secondi fatturati:

  • 480p: $0.0679/secondo, un video di 5 secondi costa circa $0.34.
  • 720p: $0.1525/secondo, un video di 5 secondi costa circa $0.76.

Se si inserisce un numero intero da 4 a 30 come durata, la fatturazione avviene sui secondi indicati; se si inserisce -1 (automatico), la fatturazione avviene sulla durata effettiva del video arrotondata, con un minimo di 4 secondi. Per controllare il budget, inserire un numero fisso di secondi.

Parametri della richiesta

  • prompt (obbligatorio): spiega come usare i materiali, indicandoli in ordine con @image1, @audio1, massimo 5000 caratteri.
  • reference_image_urls / reference_audio_urls: array di URL delle immagini di riferimento e degli audio di riferimento.
  • duration: numero intero da 4 a 30, oppure -1 per automatico; predefinito 5.
  • resolution: 480p o 720p, predefinito 480p.
  • aspect_ratio: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, oppure adaptive per adattarsi ai materiali di riferimento, predefinito adaptive.
  • omni_reference_task_type: fisso su reference (valore predefinito, può essere omesso).
  • output_format: mp4 (predefinito) o mov; generate_audio: predefinito true, genera dialoghi, effetti sonori e suoni di sottofondo sincronizzati.

Come scrivere il prompt

Innanzitutto numerare i materiali nell'ordine di comparsa, poi spiegare punto per punto cosa rappresenta ciascun materiale e come deve risultare l'immagine finale. Ad esempio:

Il prodotto in @image1 è posizionato su un tavolo di legno e ruota lentamente in esposizione, lo sfondo è la finestra mattutina di @image2,
la camera si avvicina lentamente da piano medio a primo piano, il ritmo dell'immagine segue i colpi di batteria di @audio1, mantenendo invariati i riflessi metallici del prodotto.

Con più immagini di riferimento, specificare quale è il soggetto e quale è la scena o lo stile è molto più stabile che scrivere solo «fai riferimento a queste immagini». Se si usa un audio di riferimento, indicare a quale parte dell'audio devono corrispondere i movimenti dell'immagine.

Domande frequenti

  • La richiesta viene rifiutata per mancanza di materiali: è necessario almeno un'immagine di riferimento o un audio di riferimento.
  • L'immagine di riferimento non si carica: verificare prima se il formato è nella lista supportata, se il lato singolo è tra 300 e 6000 pixel e se il rapporto d'aspetto è tra 0.4 e 2.5.
  • L'audio viene rifiutato: ogni segmento deve essere da 2 a 30 secondi e inferiore a 15 MB, il totale di più segmenti non deve superare 30 secondi.
  • Il costo non corrisponde alle aspettative: verificare se è stata usata la durata automatica -1, poiché la durata automatica viene fatturata sui secondi effettivi del video.

Consigli per la messa in produzione

Iniziare con una sola immagine di riferimento e un video di 5 secondi a 480p per verificare la catena e i criteri di addebito; poi aggiungere un audio di riferimento o più immagini di riferimento ed eseguire un'altra richiesta, confrontando se l'immagine utilizza i materiali secondo la numerazione nel prompt. Conservare i record di queste due richieste come base di riferimento, così quando in seguito si modificano i prompt o i materiali si avrà un termine di paragone. I parametri e i prezzi fanno fede secondo quanto indicato nella pagina del modello al momento corrente.

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