Introduzione
Seedance 2.0 Fast riferimenti in video riunisce più fonti autorizzate in un’unica ripresa: immagini per il chi e il cosa, clip per movimento e ritmo, audio per il battito su cui cade il taglio. Non accetta un primo fotogramma.
Seedance 2.0 Fast è il livello veloce della linea Seedance 2.0 di ByteDance. I suoi endpoint restituiscono clip da 4 a 15 secondi a 480p o 720p, con audio generato insieme all’immagine.
Scegli la modalità di Seedance 2.0 Fast in base al materiale di partenza
| Materiale di partenza | Modalità |
|---|---|
| Una sceneggiatura o la descrizione di una scena | Seedance 2.0 Fast Testo in video |
| Un’immagine iniziale approvata | Seedance 2.0 Fast Immagine in video |
| Riferimenti separati per aspetto, movimento o audio | Seedance 2.0 Fast Riferimenti in video |
Caratteristiche principali
Un solo set di campi, tre sorgenti
I tre endpoint accettano gli stessi campi di base: prompt, duration_seconds da 4 a 15 (o -1 per lasciare la scelta al modello), resolution a 480p o 720p, aspect_ratio, generate_audio e seed. Cambia solo la sorgente che ancora l’immagine: nessuna, un fotogramma iniziale o un insieme di riferimenti. Una richiesta passa da una modalità all’altra aggiungendo o togliendo quella sorgente.
Immagine e audio in un’unica passata
generate_audio è attivo di default e genera ambiente, effetti di movimento e voce sincronizzati con i fotogrammi. Disattivarlo non abbassa la tariffa in questo livello, quindi spegnilo solo per loop muti o per materiale che sonorizzerai in post-produzione.
Formato adattivo di default
aspect_ratio è adaptive di default: immagine in video mantiene le proporzioni del fotogramma iniziale, riferimenti in video segue il riferimento principale e testo in video lascia al modello la forma suggerita dal prompt. I sei formati fissi, 16:9, 9:16, 4:3, 3:4, 1:1 e 21:9, sono disponibili quando la destinazione impone la forma.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Obbligatorio, e qui fa anche il casting. almeno 1 caratteri |
reference_image_urls | No | Fino a 9 immagini che sei autorizzato a usare, per un personaggio, un prodotto, uno stile o un set. al massimo 9 elementi |
reference_video_urls | No | Fino a 3 clip che forniscono movimento, ritmo o linguaggio di macchina. al massimo 3 elementi |
reference_audio_urls | No | Fino a 3 file audio, da 2 a 15 secondi ciascuno e 15 in tutto, ognuno sotto i 15 MB, che danno all'inquadratura un'ancora sonora — dizione, tempo, una frase musicale — a cui si… al massimo 3 elementi |
aspect_ratio | No | Inquadratura in uscita, adaptive per impostazione predefinita: la clip prende la forma del riferimento principale. |
resolution | No | Risoluzione in uscita: 480p, oppure 720p per impostazione predefinita. Seleziona una fascia tariffaria e non renderà più nitidi i riferimenti a bassa risoluzione. |
duration_seconds | No | Durata della clip finita in secondi interi, da 4 a 15, predefinita 5; con -1 sceglie il modello e la stima considera 15 secondi. |
generate_audio | No | Decide se viene generata una colonna sonora nativa sincronizzata con le immagini. Attivo per impostazione predefinita; disattivarlo non abbassa la tariffa in questo livello. 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.022539 / secondo | $0.04499712 / secondo |
| $0.048471 / secondo | $0.096768 / secondo |
Casi d’uso
Un prodotto da ogni angolazione
Due o tre angolazioni dello stesso oggetto lo tengono molto meglio di una pila di immagini quasi identiche. L’esempio pubblicato invia tre viste di una sneaker e chiede una rotazione su piatto girevole attraverso quelle viste in ordine, mantenendo identici la grana della pelle, la suola e i lacci.
Un movimento di camera preso in prestito
Una clip di riferimento può fornire linguaggio di camera invece che contenuto. Uno degli esempi prende la lenta salita di un braccio gru da una clip, la mette in scena sopra un tetto preso da un’immagine di riferimento e fa coincidere il punto più alto con il crescendo di una traccia di riferimento.
Un cast fisso lungo una serie
Tieni un set di riferimenti per un personaggio, un capo o un ambiente e cambia solo il prompt tra una richiesta e l’altra. Le stesse immagini reggono ogni episodio, così l’identità resta stabile mentre l’azione va avanti.
Consigli avanzati
Fai il casting nel prompt
Qui il prompt è obbligatorio ed è lui a fare il casting. I riferimenti vengono letti nell’ordine in cui li invii, quindi di’ quale immagine è quale personaggio, cosa porta ogni clip e a cosa serve l’audio. Chiamarli @Image1, @Image2 e così via rende la corrispondenza inequivocabile.
Resta nei limiti dei riferimenti
reference_image_urls accetta fino a 9 immagini, reference_video_urls fino a 3 clip e reference_audio_urls fino a 3 tracce. Serve almeno un’immagine o una clip, perché l’audio da solo viene rifiutato. Clip e audio durano da 2 a 15 secondi ciascuno e 15 secondi in totale, e i secondi delle tue clip di riferimento si pagano in aggiunta all’output, quindi tagliali alla parte che vuoi usare.
Adatta l’esempio incluso
L’esempio pubblicato usa aspect_ratio 1:1, duration_seconds 5, generate_audio true e resolution 720p, con tre foto del prodotto in reference_image_urls.
Treat @Image1, @Image2 and @Image3 as three angles of one sneaker. Rotate it smoothly on an invisible turntable through those three views in order, keeping the leather grain, gum sole and lacing identical throughout. Hard studio key stays fixed; the contact shadow swings with the rotation.
Ogni riferimento è indicato dalla sua posizione e riceve un solo compito. Sostituisci il prodotto e mantieni questa struttura.
Usa immagine in video quando il primo fotogramma deve essere esatto
Questo endpoint non ha campi per il primo o l’ultimo fotogramma. Quando l’immagine d’apertura deve corrispondere esattamente a una foto, invia quella foto a immagine in video e descrivi solo il movimento.
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-fast/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.
















