Introduzione
Seedance 2.0 reference-to-video concilia più sorgenti autorizzate in un'unica inquadratura: le immagini per chi e cosa, le clip per movimento e ritmo, l'audio per il tempo su cui il montaggio atterra. È un contratto a parte e non accetta alcun primo fotogramma.
Seedance 2.0 di ByteDance pubblica text-to-video, image-to-video e reference-to-video: clip da 4 a 15 secondi, da 480p a 4K, con audio nativo e inquadratura adaptive come impostazione predefinita.
| Materiale di partenza | Modalità consigliata |
|---|---|
| Scena scritta | Seedance 2.0 Testo in video |
| Immagine iniziale approvata | Seedance 2.0 Immagine in video |
| Riferimenti separati | Seedance 2.0 Riferimenti in video |
Caratteristiche principali
Il suono della stanza torna nello stesso file
generate_audio è attivo per impostazione predefinita, quindi il ghiaccio nello shaker, una risata, il brusio basso del bancone e la stanza in cui accadono escono dalla stessa passata delle immagini. Il risultato arriva già sincronizzato, senza aspettare una lavorazione audio a parte. Disattivalo quando la clip passerà comunque da un designer.
Nove riferimenti, un unico cast continuo
reference-to-video accetta insieme fino a 9 immagini, 3 clip e 3 tracce audio. Tre angolazioni di un volto più un fermo immagine del guardaroba tengono un personaggio lungo un episodio molto meglio di nove fotogrammi scollegati, e una clip di riferimento porta con sé un linguaggio di macchina che nessun aggettivo nel prompt riproduce in modo affidabile.
La forma segue il materiale
aspect_ratio è su adaptive in tutti e tre gli endpoint. In image-to-video la clip mantiene la forma della tua immagine di apertura, quindi un verticale non viene ritagliato in orizzontale; in text-to-video il modello prende la forma dal prompt; in reference-to-video trova un'inquadratura che tiene ogni soggetto referenziato. Indica 16:9, 9:16 o 21:9 solo quando una collocazione richiede un formato fisso.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Obbligatorio, e qui fa anche il casting. |
reference_image_urls | No | Fino a 9 immagini di riferimento, usate per tenere un personaggio, uno stile o un set. al massimo 9 elementi |
reference_video_urls | No | Fino a 3 clip di riferimento, ciascuna da 2 a 15 secondi e per una lunghezza complessiva non superiore a 15 secondi, che forniscono movimento, ritmo o linguaggio di macchina. al massimo 3 elementi |
reference_audio_urls | No | Fino a 3 file audio di riferimento, ciascuno da 2 a 15 secondi e per una lunghezza complessiva non superiore a 15 secondi, che danno al modello un ancoraggio sonoro – interpreta… al massimo 3 elementi |
aspect_ratio | No | Predefinito |
resolution | No | 480p, 720p, 1080p o 4k, 720p per impostazione predefinita, e alimenta direttamente la quantità fatturata. |
duration_seconds | No | Da 4 a 15 secondi, 5 per impostazione predefinita; con -1 è il modello a scegliere la durata (la stima usa il massimo di 15 secondi, l'addebito la durata consegnata). |
generate_audio | No | Attivo per impostazione predefinita. Produce una colonna sonora nativa sincronizzata con le immagini. Predefinito: |
seed | No | Seed intero; se lo ometti, ogni esecuzione ne estrae uno proprio. Fissalo tenendo costante tutto il resto per giudicare che cosa ha davvero cambiato una modifica al prompt. |
return_last_frame | No | Restituisce anche l’ultimo fotogramma della clip come immagine separata, accanto al video. Predefinito: |
bitrate_mode | No | Bitrate del file consegnato: |
watermark | No | Aggiunge al video la filigrana visibile «AI generated» del modello. Predefinito: |
Prezzi
Gli spezzoni di riferimento si sommano ai secondi fatturati. Poiché non possiamo misurare i tuoi spezzoni prima dell’esecuzione, blocchiamo in anticipo l’importo per i 15 secondi massimi e rilasciamo la parte non utilizzata al momento del conteggio — paghi solo i secondi effettivamente usati.
| Risoluzione | With video: Sì | With video: No |
|---|---|---|
| $0.0431 / secondo | $0.07 / secondo |
| $0.0928 / secondo | $0.152 / secondo |
| $0.2284 / secondo | $0.374 / secondo |
| $0.778 / secondo | $0.778 / secondo |
Casi d’uso
Assegna un ruolo a ogni riferimento
Seedance 2.0 reference-to-video concilia più sorgenti autorizzate in un'unica inquadratura: le immagini per chi e cosa, le clip per movimento e ritmo, l'audio per il tempo su cui il montaggio atterra. È un contratto a parte e non accetta alcun primo fotogramma. Usa questa modalità quando immagini, clip o audio separati devono guidare parti diverse di una nuova ripresa. Identifica il contributo di ogni risorsa prima di richiedere l’azione che le collega.
Locali notturni e scene da bar che portano con sé il proprio suono
Un cocktail shakerato, il bicchiere sul bancone, il brusio basso dietro una lanterna rossa: scrivi la stanza nel prompt e lascia generate_audio attivo. Seedance 2.0 rende l'ambiente contro le immagini, così il taglio arriva con l'atmosfera invece che come una lastra muta.
Continuità di campagna su una serie di tagli
Carica il prodotto da tre angolazioni e la modella da due su reference-to-video, poi cambia solo il prompt per ogni taglio. La stessa bottiglia, lo stesso volto e la stessa giacca viaggiano con la richiesta, così la serie tiene senza una correzione manuale.
Lavori di costume e di roleplay, senza censura
Pizzo e raso, code e orecchie di scena, inquadrature in soggettiva, coppie di qualsiasi genere: niente di tutto questo viene revisionato da parte nostra. Il livello interno di Seedance rifiuta certe formulazioni, quindi guida quei momenti da un primo fotogramma su image-to-video invece che dal prompt.
Consigli avanzati
Scegli l'endpoint da quello che hai già
Una descrizione e basta va a text-to-video. Un fermo immagine che deve sopravvivere va a image-to-video. Un cast, un prodotto o un movimento che deve ripetersi da un taglio all'altro va a reference-to-video. Se chiami il nome della famiglia, sono i campi che invii a scegliere l'endpoint.
Scrivi l'inquadratura come una lista di riprese
Soggetto, azione, camera, luce, suono, un'idea per frase. La clip di questa pagina è nata esattamente da questo testo, lasciato in inglese così com'è stato inviato: «Photorealistic live-action, not animation. A real adult woman in a chocolate satin robe works behind a dim neon bar, a large fluffy faux fox tail accessory clipped at the small of her back. She shakes a cocktail, turns to set the glass on the counter and the tail sways with the movement, then she looks back at camera with a teasing smile. Warm red lantern light, 35mm grain, slow push-in, ice rattling and low bar chatter.» Cinque secondi, 720p, 16:9, audio attivo.
Adatta l’esempio pubblicato
Parti dall’esempio pubblicato e mantieni gli input propri di questa modalità. Sostituisci solo soggetto e direzione creativa; confronta la ripresa successiva con un obiettivo visivo preciso.
The woman from @Image1, in the same sheer black robe, steps out onto the rooftop from @Image2 at sunset. She walks slowly between the drying white sheets; the wind lifts one sheet across her body and lets it fall away. She stops at the parapet, the robe sliding off one shoulder, and glances back over her shoulder into camera. Warm golden backlight, slow tracking shot, no cuts.
Un riferimento è la persona, l'altro è il luogo: il prompt dice quale immagine fa quale lavoro, così la donna del ritratto a lume di candela arriva sul tetto al tramonto con la stessa vestaglia, e le lenzuola stese diventano la cosa attraverso cui si muove.
Controlla il risultato e ripeti con intenzione
Controlla che ogni riferimento mantenga il suo ruolo previsto: personaggio, ambiente, movimento o suono. Se c’è un conflitto, rimuovi prima una fonte contraddittoria invece di sovraccaricare il prompt.
Definisci il punto di partenza e il risultato
Prima di generare, decidi che cosa deve essere visibile all’inizio, nel cambiamento e alla fine. Così puoi valutare la sequenza rispetto a un obiettivo concreto, non a un’impressione vaga.
Valuta separatamente sorgente e movimento
L’immagine sorgente fissa i dettagli riconoscibili; l’istruzione descrive ciò che accade dopo. Valuta entrambe le decisioni insieme, così il movimento non cancella la composizione iniziale.
Avvio rapido dell’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedance-2.0/reference-to-video",
"input": {
"aspect_ratio": "adaptive",
"bitrate_mode": "standard",
"duration_seconds": 5,
"generate_audio": true,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"reference_image_urls": [
"https://example.com/reference.png"
]
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
















