Seedance 2.5 Flash API
Guida completa all’API dei modelli di generazione video Seedance 2.5 Flash di ByteDance.
Varianti del modello
Questa API supporta tre varianti del modello:
Confronto rapido
Rapporti d’aspetto supportati
Le varianti che generano video da testo e da riferimenti supportano i seguenti rapporti d’aspetto:
21:9, 16:9, 9:16, 1:1, 4:3, 3:4
La variante che genera video da un’immagine non supporta il parametro aspect_ratio.
Risoluzioni disponibili
Seedance 2.5 Flash Text to Video
Endpoint
POST /api/v1/video/task
Parametri della richiesta
Obbligatori
Facoltativi
Esempio di richiesta
javascript
Seedance 2.5 Flash Image to Video
Parametri della richiesta
Obbligatori
Facoltativi
Non includere
aspect_rationelle richieste di generazione video da un’immagine. Il modello non supporta questo parametro.
Esempio di richiesta
javascript
Seedance 2.5 Flash Reference to Video
Parametri della richiesta
Obbligatori
Contenuti multimediali di riferimento
Tutti i contenuti multimediali di riferimento sono facoltativi. È possibile inviare richieste con sole immagini, solo video, solo audio oppure senza alcun riferimento. Per la generazione senza riferimenti si consiglia la variante Text to Video.
Segnaposto di riferimento @ (AT)
La funzione di riferimento @ (AT) collega i contenuti multimediali di riferimento al prompt tramite segnaposto numerati nel formato <<<...>>>. Per ogni tipo di contenuto la numerazione parte da 1 e segue l’ordine dell’array corrispondente:
Ad esempio, se la prima immagine è il riferimento per un personaggio e la seconda per una scena, usare <<<image_1>>> per il personaggio e <<<image_2>>> per la scena in prompt. Ogni segnaposto deve corrispondere a un elemento presente nel relativo array.
Facoltativi
Esempio di richiesta
javascript
Esempio di richiesta di generazione video con riferimenti @ (AT)
javascript
Limiti dei contenuti multimediali
Questi limiti si applicano alle immagini del primo e dell’ultimo fotogramma e ai contenuti multimediali di riferimento per i modelli descritti in questa pagina.
Le clip audio e i video di riferimento hanno limiti di durata complessiva separati, pari a 30 secondi per ciascun tipo. Anche i limiti numerici sono indipendenti: fino a 10 immagini, 5 video e 5 clip audio.
Tutti i modelli richiedono resolution e duration, senza valori predefiniti. Se si omette aspect_ratio, le varianti che generano video da testo e da riferimenti usano 16:9. L’audio è attivo per impostazione predefinita (true). Impostare il valore su false per generare un video muto.
Formato della risposta
Risposta iniziale
Tutti i modelli restituiscono un task_id da usare per le richieste periodiche di verifica dello stato:
json
Risposta alla richiesta di stato
Interrogare periodicamente GET /api/v1/video/{taskId} per verificare lo stato:
json
Valori di stato
submitted: Richiesta accettata e in attesa di elaborazioneprocessing: Generazione del video in corsosucceed: Generazione del video completatafailed: Generazione del video non riuscita
Tempo di elaborazione
Il tempo di elaborazione varia in base alla durata, alla risoluzione e allo stato della coda.
Verificare lo stato ogni 5–10 secondi.
Buone pratiche
- Parametri obbligatori: fornire sempre
prompt,resolutioneduration. Per la generazione da testo e da riferimenti,aspect_ratioè facoltativo e il valore predefinito è16:9 - Rapporto d’aspetto per la generazione da un’immagine: non inviare
aspect_rationelle richieste di questo tipo - Video di riferimento: i video sono facoltativi. La durata di ciascun video e la durata complessiva devono rispettare i limiti indicati
- Immagini di riferimento: le immagini sono facoltative indipendentemente dai video e dall’audio. Fornire fino a 10 URL di immagini in formati supportati
- Audio di riferimento: ogni clip deve durare da 2 a 30 secondi e non superare i 15 MB, con una durata complessiva massima di 30 secondi
- Ordine dei riferimenti: disporre gli elementi di
images,videoseaudiosnell’ordine desiderato e rispettare tale ordine quando si richiamano i riferimenti nel prompt - Audio: omettere
soundper usare il valore predefinitotrueoppure impostarlo sufalseper disattivare la generazione dell’audio