Seedance 2.0 API
Riferimento API completo per i modelli di generazione video Seedance 2.0 di ByteDance.
Varianti dei modelli
Questa API supporta sei varianti:
Confronto rapido
Proporzioni supportate
21:9, 16:9, 9:16, 1:1, 4:3, 3:4
Opzioni di risoluzione
Seedance 2.0 Da testo a video
Punto di accesso
POST /api/v1/video/task
Parametri della richiesta
Obbligatori
Facoltativi
Esempio di richiesta
javascript
Seedance 2.0 Da immagine a video
Parametri della richiesta
Obbligatori
Facoltativi
Esempio di richiesta
javascript
Seedance 2.0 Da riferimenti a video
Parametri della richiesta
Obbligatori
Media di riferimento
Invia 1-9 immagini. Le immagini possono essere omesse solo se viene fornito almeno un video di riferimento.
Segnaposto di riferimento @ (AT)
La funzione @ (AT) collega i media di riferimento al prompt tramite segnaposto numerati <<<...>>>. La numerazione inizia da 1 separatamente per ogni tipo di media e segue l'ordine del rispettivo array:
Ad esempio, se la prima immagine è un riferimento per il personaggio e la seconda per la scena, usa <<<image_1>>> per il personaggio e <<<image_2>>> per la scena in prompt. Ogni segnaposto deve indicare un elemento presente nel rispettivo array.
Facoltativi
Esempio di richiesta
javascript
Esempio di richiesta Da riferimenti a video con @ (AT)
javascript
Varianti Fast
Le varianti Fast privilegiano la velocità di elaborazione. Tutti i modelli Fast supportano solo l'uscita "480p" e "720p". Fast Da testo a video e Fast Da immagine a video seguono per il resto le strutture di richiesta dei rispettivi modelli standard, mentre Fast Da riferimenti a video usa gli stessi limiti dei media di riferimento del modello standard.
Esempio di richiesta Fast
javascript
Esempio di richiesta Fast Da riferimenti a video con @ (AT)
javascript
Parametri Seedance 2.0 Fast Da riferimenti a video
Obbligatori
Media di riferimento
La stessa convenzione dei segnaposto con numerazione da 1 si applica anche al modello Fast Da riferimenti a video.
Facoltativi
Limiti dei media
Questi limiti si applicano alle immagini del primo e dell'ultimo fotogramma e ai media di riferimento dei modelli in questa pagina.
Audio e video di riferimento hanno ciascuno un limite separato di durata totale di 15 secondi. I conteggi sono indipendenti: fino a 9 immagini, 3 video e 3 clip audio. Aggiungere video non riduce il numero di immagini consentite.
Tutti i modelli usano 720p per impostazione predefinita, ma resolution deve comunque essere fornito. L'interruttore del suono è impostato su true; né questo né l'audio di riferimento modificano il prezzo. Da riferimenti a video richiede almeno un'immagine o un video; le richieste solo audio non sono supportate. Caricare video di riferimento raddoppia il costo di generazione, indipendentemente dal numero o dalla durata.
Formato della risposta
Risposta iniziale
Tutti i modelli restituiscono un task_id per il polling:
json
Risposta di polling
Interroga GET /api/v1/video/{taskId} per verificare lo stato:
json
Valori di stato
submitted: attività accettata e in attesa di elaborazioneprocessing: generazione video in corsosucceed: generazione video completatafailed: generazione video non riuscita
Tempo di elaborazione
Modelli standard: 3-8 minuti in base a durata e risoluzione.
Modelli Fast: 1-4 minuti per la maggior parte delle configurazioni.
Verifica lo stato ogni 5-10 secondi.
Buone pratiche
- Scegliere la variante adatta: usa modelli Fast per le iterazioni e modelli standard per l'uscita finale
- Descrivere chiaramente il movimento: inserisci descrizioni specifiche dei movimenti nei prompt
- Scelta della risoluzione: tutti i modelli standard Seedance 2.0 supportano
480p,720p,1080pe4k; tutti i Fast supportano solo480pe720p - Ordine dei riferimenti: ordina intenzionalmente
images,videoseaudiose richiamali in modo coerente nel prompt - Richieste solo video: usa un array
imagesvuoto solo quando fornisci almeno un video di riferimento - Durata dei media: mantieni ogni audio e video di riferimento tra 2 e 15 secondi
- Uso dell'audio: ometti
soundper usare il valore predefinitotrue, oppure impostalo sufalseper disattivare il suono generato