Introduzione
Estensione video con Seedance 2.5. Invia la clip da continuare e un prompt su cosa succede dopo: al massimo i suoi ultimi 30 secondi vanno a Seedance 2.5 reference-to-video come video di riferimento, così il nuovo segmento riprende il movimento, la camera e il suono del finale. La clip completa e il nuovo segmento tornano uniti in un solo MP4. Paghi solo i secondi di riferimento e i secondi nuovi.
| Campo | Valore |
|---|---|
| Input | Video |
| Output | Video |
| Endpoint | text-to-video, image-to-video, reference-to-video |
| Durata clip | Da 4 a 30 secondi interi, 5 per impostazione predefinita |
| Risoluzione | 480p, 720p (predefinita), 1080p |
| Proporzioni | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive (predefinita); solo adaptive su image-to-video |
| Audio | Colonna sonora nativa renderizzata nella stessa passata, attiva di default |
| Referenze | Fino a 30 immagini, 10 video, 10 tracce audio – solo su reference-to-video |
Caratteristiche principali
Il suono torna nello stesso file dell'immagine
generate_audio è acceso di default, quindi la traccia esce dalla stessa passata dei fotogrammi invece di essere sonorizzata dopo. I passi cadono dove cade il piede, una battuta sussurrata sta sulla bocca che la dice e la stanza sta dietro a entrambe. Spegnilo quando la clip andrà comunque a un sound designer.
Trenta referenze, una sola ripresa
reference-to-video accetta fino a 30 immagini, 10 clip e 10 tracce audio in una sola richiesta. Tre angolazioni dello stesso volto tengono un personaggio lungo una serie molto meglio di trenta fotogrammi scollegati; le clip di riferimento portano movimento e ritmo, l'audio di riferimento dà al montaggio qualcosa su cui atterrare. È un endpoint a parte e non accetta primo fotogramma.
Primo fotogramma, ultimo fotogramma e trenta secondi in mezzo
image-to-video inchioda il fotogramma di apertura a un'immagine che fornisci tu. Aggiungi last_image_url e la ripresa deve arrivare in un punto preciso: è questo che rende ripetibili transizioni, rivelazioni e coppie prima/dopo. Oltre i dieci secondi circa una singola ripresa comincia a derivare, quindi più riprese brevi montate in sequenza di solito reggono meglio di una sola presa lunga.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Obbligatorio. Descrivi cosa succede dopo: l'azione che segue, il movimento di camera e il suono. |
video_url | Sì | La clip da continuare: MP4, MOV o WebM, da 2 a 60 secondi. almeno 1 caratteri |
resolution | No | Dimensione del nuovo segmento: 480p, 720p o 1080p, predefinita 720p. Stabilisce solo la qualità del nuovo segmento: scegli l’impostazione della tua clip. |
duration_seconds | No | Durata del nuovo segmento: qualsiasi numero intero da 4 a 30, predefinito 5. |
generate_audio | No | Attivo per impostazione predefinita: il nuovo segmento ha un audio generato che segue il riferimento. Predefinito: |
enable_web_search | No | Disattivato per impostazione predefinita. Se lo attivi, il modello può cercare sul web informazioni legate al prompt prima di generare il nuovo segmento. Predefinito: |
seed | No | Da 0 a 2147483647. Tienilo fisso per confrontare cambiando un solo campo alla volta; omettilo per avere varietà. |
watermark | No | Disattivato per impostazione predefinita. Se attivo, il nuovo segmento porta una filigrana che lo segnala come generato con IA; la tua clip non viene toccata. Predefinito: |
Prezzi
Si paga al secondo il materiale di riferimento più il nuovo segmento, alla tariffa di Seedance 2.5 reference-to-video con video di riferimento per la risoluzione e l'impostazione audio scelte. Il riferimento sono al massimo gli ultimi 30 secondi della tua clip, arrotondati al secondo intero, e vale il minimo di Seedance (un segmento di 5 secondi addebita almeno 4 secondi di riferimento). Le parti precedenti della clip non si pagano. Per un link che non possiamo misurare in anticipo vengono trattenuti 30 secondi di riferimento e la parte non usata viene liberata al saldo.
| Risoluzione | With video: Sì | With video: No |
|---|---|---|
| $0.0738 / secondo | $0.1234 / secondo |
| $0.1659 / secondo | $0.2773 / secondo |
| $0.4082 / secondo | $0.6823 / secondo |
Casi d’uso
Scene da bar, da club e dietro le quinte
Il tipo di ripresa che ha bisogno del proprio rumore: il ghiaccio nello shaker, una battuta sussurrata, un sassofono due stanze più in là. Scrivi la stanza dentro il prompt e lascia generate_audio acceso – Seedance 2.5 renderizza l'ambiente contro l'immagine invece di consegnarti una pista muta.
Corti senza censura, anche con coppie
Le scene che l'app ufficiale blocca, con coppie di qualunque genere, girano qui, e non verifichiamo ciò che generi. Il livello di sicurezza proprio di Seedance rifiuta ancora alcune formulazioni sui baci, quindi la via affidabile è un fotogramma iniziale in immagine-video.
Film di prodotto che partono dal packshot
Manda la fotografia approvata a image-to-video: geometria, etichetta e color grade restano esattamente come sono stati scattati mentre la camera si muove. Non c'è nulla da rilluminare o da riapprovare, e last_image_url fa atterrare il movimento di nuovo sul fotogramma chiave per un loop pulito.
Personaggi seriali che restano la stessa persona
Costruisci un piccolo set di referenze – tre angolazioni del volto, un'immagine del guardaroba, una clip della camminata – e riusalo tra un episodio e l'altro su reference-to-video. Trenta immagini stanno in una sola richiesta, quindi il cast viaggia con il prompt invece che con un seed.
Consigli avanzati
Scegli l'endpoint da quello che hai già
Una descrizione e nient'altro va a text-to-video. Un'immagine che vuoi conservare va a image-to-video. Un cast, un prodotto o un movimento che deve sopravvivere a più riprese va a reference-to-video. Se chiami il nome della famiglia, sono i campi che invii a scegliere l'endpoint.
Scrivi la ripresa, non l'immagine
Soggetto, azione, camera, luce, suono – in quest'ordine, un'idea per frase. La clip di questa pagina è nata esattamente da questo testo, lasciato in inglese così come è stato inviato: «Warm, clearly lit close two-shot. Two adult women stand very close in the amber glow of a jazz bar's back hallway, one in a black velvet slip, the other in an open white shirt. One leans in and whispers something against the other's ear; the other closes her eyes and breaks into a wide laugh, then they rest their foreheads together. Handheld 35mm, warm practical lights, shallow focus, muffled saxophone, a whispered line and soft laughter.» Cinque secondi, 720p, 16:9, audio acceso.
Crealo come task asincrono e interroga lo stato
Invia un Idempotency-Key, conserva l'id del task che ricevi, poi interroga lo stato o raccogli il callback. Dopo una connessione caduta, cerca il task invece di ricrearlo. Guarda prima la stima: la muovono
duration_secondse resolution, e su reference-to-video anche il materiale di riferimento.
Introduzione
Seedance 2.5 Estensione video continua una clip che hai già. Inviala come video_url con un prompt su cosa succede dopo. La piattaforma prende al massimo gli ultimi 30 secondi della clip (la clip intera, se più corta) e li passa a Seedance 2.5 reference-to-video come video di riferimento. Il modello genera un nuovo segmento di 4-30 secondi che porta avanti la scena, e i due vengono uniti in un solo MP4: prima il tuo originale completo, poi la continuazione. Il nuovo segmento torna anche come file a sé, così puoi estendere ancora o montare le parti separatamente.
Funzionalità principali e punti di forza
La continuità nasce da un tratto di video, non da un solo fotogramma. Seedance legge il finale della clip, con movimento, direzione della camera e suono, come contesto, quindi velocità e direzione proseguono meglio di quando un modello vede solo un fermo immagine. Il primo fotogramma nuovo è generato, non copiato dall'ultimo: descrivi il movimento da continuare e mantieni lo stesso linguaggio di camera.
Paghi ciò che il modello legge e ciò che crea. Il prezzo è la tariffa al secondo di Seedance 2.5 reference-to-video con video di riferimento, applicata ai secondi di riferimento più i secondi nuovi. Il riferimento ha un tetto di 30 secondi: una sorgente di 60 secondi addebita 30 secondi di riferimento, tutto ciò che viene prima è solo letto e riunito. I secondi di riferimento si arrotondano al secondo intero e vale il minimo di Seedance: un segmento di 5 secondi addebita almeno 4 secondi di riferimento.
Un file di ritorno, più la parte nuova da sola. Il file unito mantiene il frame rate e l’inquadratura del tuo clip, senza bande nere, ed è codificato come MP4 H.264 con audio AAC. Per allineare la giunzione, l’immagine può essere ritagliata o regolata di qualche punto percentuale ai bordi. Se il modello restituisce proporzioni nettamente diverse, il nuovo segmento viene ridimensionato per riempire la tua inquadratura e centrato, e ciò che sporge viene ritagliato. L'audio della tua clip resta, quello generato per il nuovo segmento lo segue con una breve dissolvenza sul raccordo, e un lato muto viene completato con silenzio. Il secondo asset dell'output è solo il nuovo segmento.
Tutto il resto è Seedance 2.5 reference-to-video. Il nuovo segmento passa dagli stessi percorsi, con lo stesso margine sui contenuti di quell'endpoint, e una generazione fallita viene rimborsata allo stesso modo. Se la generazione riesce ma l'unione non si può costruire, il task fallisce e l'addebito viene rimborsato. Una sorgente sotto i 2 secondi è troppo corta per essere continuata e viene rifiutata.
Casi d'uso
Allunga un'inquadratura finita troppo presto: un ballo che si interrompe a metà passo, una carrellata che si chiude prima che la persona arrivi alla porta, un prodotto che smette di ruotare prima che l'etichetta guardi in camera. Estendila e descrivi l'azione che manca.
Costruisci una sequenza più lunga un passo alla volta. Genera una prima inquadratura, estendila, poi estendi di nuovo il risultato unito. Ogni passo addebita il riferimento letto (al massimo 30 secondi) più i secondi aggiunti. Le sorgenti hanno un limite di 60 secondi, quindi in una catena lunga estendi l'ultimo segmento invece dell'intera clip unita.
Guida ai prompt e consigli
Descrivi il momento successivo, non tutta la scena. Il riferimento mostra già chi e dove, quindi usa il prompt per l'azione che segue, il movimento di camera e il suono. Riprendi il linguaggio di camera con cui finisce la tua clip, come una lenta carrellata in avanti o una camera a mano, così il raccordo sembra un'unica ripresa.
Fai finire la sorgente dove vuoi proseguire. Seedance si appoggia agli ultimi secondi del riferimento; una clip che finisce a metà stacco, su una dissolvenza o su un'altra inquadratura porta la continuazione fuori strada. Taglia prima. Si accettano sorgenti da 2 a 60 secondi in MP4, MOV o WebM.
Mantieni la stessa risoluzione. La risoluzione stabilisce solo la qualità del nuovo segmento, quindi un segmento a 480p dopo una clip a 1080p appare più morbido dell’originale. Scegli la risoluzione della tua clip e imposta duration_seconds sulla durata che ti serve davvero: si somma ai secondi di riferimento nel costo.
Usa solo adulti consenzienti e materiale in licenza. Chiunque compaia in un'immagine, in una clip o in un file audio di riferimento deve aver dato il permesso. Nessun minore, nessuna immagine intima non consensuale, nessuna impersonificazione ingannevole di persone reali.
Le liberatorie su copyright e immagine per ogni immagine, clip e file audio di riferimento, insieme ai diritti su marchio, musica e uso commerciale, restano a carico di chi chiama l'API.
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.5/video-extend",
"input": {
"duration_seconds": 5,
"generate_audio": true,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"video_url": "https://example.com/reference.mp4"
}
}'
# 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.
