Introduzione
Seedance 2.0 Fast testo in video costruisce l’intera inquadratura dal prompt — soggetto, set, camera, luce — e genera la colonna sonora nella stessa passata. Niente àncora l’immagine, quindi è l’endpoint per una ripresa che non esiste ancora.
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ì | L'unica fonte di ciò che appare sullo schermo. Ordinalo così: soggetto, azione, macchina, luce, suono, un'idea per frase. almeno 1 caratteri |
aspect_ratio | No | Inquadratura in uscita: adaptive per impostazione predefinita, oppure una di sei proporzioni fisse dal 21:9 al 9:16. |
resolution | No | Risoluzione in uscita: 480p, oppure 720p per impostazione predefinita. Seleziona una fascia tariffaria, e le fasce più alte significano file più grandi e rendering più lunghi. |
duration_seconds | No | Durata della clip finita in secondi interi, da 4 a 15, predefinita 5, ed è la quantità addebitata: il costo cresce di pari passo. |
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: |
enable_web_search | No | Disattivato di default. Se lo attivi, il modello può cercare sul web informazioni legate al tuo prompt prima del render. 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
| Specifiche | Prezzo |
|---|---|
| $0.04499712 / secondo |
| $0.096768 / secondo |
| $0.0702 / secondo |
| $0.1488 / secondo |
Casi d’uso
Tagli verticali per i social
Chiedi 9:16 direttamente e scrivi la ripresa come la vedrebbe un telefono: a mano, luce del giorno dal finestrino, rumore ambientale lasciato dentro. L’esempio qui sotto è esattamente questo: cinque secondi sul posto al finestrino di un autobus, generati da un prompt senza alcun girato alle spalle.
Riprese che nessuno andrà a girare
Senza un’immagine da seguire, il prompt è l’unica fonte di soggetto, set, camera e luce. Per questo è l’endpoint per establishing shot, inserti e b-roll che altrimenti richiederebbero una location e una troupe.
La prima ripresa di una sequenza più lunga
Questa linea non ha un endpoint per estendere le clip. Genera qui la ripresa d’apertura, esporta il suo ultimo fotogramma e mandalo a immagine in video come inizio della ripresa successiva: costumi, set e luce restano perché sono già dentro quel fotogramma.
Consigli avanzati
Ordina il prompt come una lista di inquadrature
Soggetto, azione, camera, luce, suono: un’idea per frase. I secondi in più di un duration_seconds più lungo servono a completare un’azione, non a infilarne una seconda; i pezzi lunghi si costruiscono concatenando le riprese.
Sappi dove interviene il filtro di Seedance
Da parte nostra non c’è alcuna revisione, ma il livello di sicurezza di Seedance rifiuta parte della formulazione prima di generare un solo fotogramma. Il bacio è il fattore scatenante costante, mentre un sussurro all’orecchio o le fronti che si toccano passano. Se ti serve un risultato letterale, porta la scena da un primo fotogramma in immagine in video.
Adatta l’esempio incluso
L’esempio pubblicato usa aspect_ratio 9:16, duration_seconds 5, generate_audio true e resolution 720p.
Vertical selfie video: an adult woman on a city bus by the window, pale blue mohair cardigan slipping off one shoulder, hair in a lace headband, she tilts the phone, winks and flashes a peace sign, then laughs and looks away. Bright overcast daylight through the window, street sliding past, authentic handheld phone-camera look, ambient bus noise.
Il prompt chiede il realismo di una fotocamera da telefono invece di quello del cinema, ed è questo a renderlo credibile come selfie. Mantieni quel registro e cambia persona, luogo e gesto.
Bozze a 480p, confronti con un seed fisso
Itera a 480p finché la formulazione cambia, poi porta resolution a 720p solo per la ripresa che tieni. Per vedere cosa ha cambiato davvero una modifica al prompt, fissa seed e lascia invariati tutti gli altri campi: è uno strumento di confronto, non una promessa di ripetizioni identiche fotogramma per fotogramma. Con duration_seconds a -1, la stima presume 15 secondi e il costo segue la durata consegnata.
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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "adaptive",
"bitrate_mode": "standard",
"generate_audio": true,
"duration_seconds": 5
}
}'
# 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.
















