Introduzione
Seedance 2.0 Mini testo in video costruisce l’intera inquadratura dal prompt — soggetto, set, camera, luce — e genera la colonna sonora nella stessa passata. È l’endpoint per le riprese che nessuno andrà a girare.
Seedance 2.0 Mini è il livello più piccolo della linea Seedance 2.0 di ByteDance. Pubblica gli stessi endpoint di Seedance 2.0 Fast e restituisce clip da 4 a 15 secondi a 480p o 720p, con audio generato nella stessa passata.
Scegli la modalità di Seedance 2.0 Mini in base al materiale di partenza
| Materiale di partenza | Modalità |
|---|---|
| Una sceneggiatura o la descrizione di una scena | Seedance 2.0 Mini Testo in video |
| Un’immagine iniziale approvata | Seedance 2.0 Mini Immagine in video |
| Riferimenti separati per aspetto, movimento o audio | Seedance 2.0 Mini Riferimenti in video |
Caratteristiche principali
Lo stesso contratto di Seedance 2.0 Fast
Mini pubblica gli stessi endpoint e gli stessi campi di Seedance 2.0 Fast: formato adattivo più sei formati fissi, da 4 a 15 secondi o -1 per una durata scelta dal modello, audio nativo e seed, con la risoluzione limitata a 720p. Una pipeline scritta per Mini passa a Fast cambiando l’id del modello, non la richiesta.
Pensato per i volumi
Mini è il livello giusto quando la produttività conta più della qualità in più dei modelli Seedance 2.0 maggiori. Ogni endpoint è asincrono: invia un Idempotency-Key con ogni richiesta, salva gli id dei task e lascia che polling o callback li risolvano. La chiave vale 24 ore, quindi un nuovo tentativo dopo una connessione caduta restituisce il task originale.
Sequenze più lunghe con l’estensione video
Per superare i quindici secondi, invia una clip finita all’endpoint video-extend: il suo ultimo fotogramma apre una nuova inquadratura di Seedance 2.0 Mini e ricevi un solo file con le due parti unite. Ogni passaggio addebita solo i secondi che aggiunge, e il risultato unito può essere esteso di nuovo.
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.0246078 / secondo |
| $0.05292 / secondo |
Casi d’uso
B-roll quotidiano in grandi quantità
Luce del mattino dalla finestra, un piumone tirato sul viso, polvere in un raggio di sole: le riprese ordinarie che un catalogo o un’app richiedono a centinaia e per cui nessuno vuole organizzare un set. L’esempio pubblicato qui sotto è esattamente questo, generato solo da un prompt.
Un brief in tutti i formati
Fissa il prompt e distribuiscilo in 16:9, 9:16 e 1:1 nello stesso batch. Poiché l’endpoint è asincrono, tre formati della stessa idea sono tre id di task da raccogliere, non tre lavori da pianificare.
Tanti look con la stessa forma di richiesta
Gli stessi campi coprono riprese dal vero e animazione stilizzata. Tra gli esempi di questo endpoint ci sono una strada bagnata di pioggia di notte con il teleobiettivo e una scena anime in cel shading presso una sorgente termale innevata; il look si decide nel prompt, senza campi aggiuntivi.
Consigli avanzati
Soggetto, azione, camera, luce, suono
Un’idea per frase, in quest’ordine. Quando un duration_seconds più lungo ti dà tempo in più, usalo per completare l’azione già descritta invece di aggiungerne un’altra.
Riformula ciò che Seedance rifiuta
Non rivediamo la formulazione, ma il livello di Seedance ne rifiuta una parte prima del rendering, e il bacio è il fattore scatenante costante. La stessa scena scritta come un sussurro all’orecchio o fronti che si toccano passa, e un primo fotogramma in immagine in video fa passare la versione letterale.
Adatta l’esempio incluso
L’esempio pubblicato usa aspect_ratio 16:9, duration_seconds 5, generate_audio true e resolution 720p.
Morning in a sunlit studio apartment. An adult woman in an oversized grey t-shirt stretches her arms overhead beside the window, the hem lifting slightly, then drops onto the unmade bed and pulls the duvet over her face laughing. Warm dust in the light shaft, handheld, soft film grain, quiet room tone and distant traffic.
Materiale ordinario con camera a mano e un ambiente di stanza silenzioso: esattamente ciò per cui esiste questo livello. Cambia la stanza e il gesto, e mantieni la struttura con una sola azione.
Spegni l’audio solo se sonorizzerai dopo
Disattivare generate_audio non cambia la tariffa in questo livello. Lascialo acceso quando l’ambiente regge la scena e spegnilo per loop muti o quando aggiungerai musica in post-produzione.
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-mini/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.
















