Seedance 2.0 Fast API

Seedance 2.0 Fast immagine in video apre la clip su un’immagine che fornisci tu e la anima fino a 15 secondi. Aggiungi un fotogramma finale e la ripresa deve arrivarci, il che rende ripetibili transizioni e coppie prima-dopo.

Seedance 2.0 Fast è il livello veloce della linea Seedance 2.0 di ByteDance. I suoi tre 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

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.

Risultati letterali da un tuo fotogramma

Ciò che mostra il fotogramma iniziale è già nella clip, quindi il prompt deve solo descrivere il movimento e non giustificare il contenuto. È la strada affidabile quando il filtro di Seedance rifiuta la stessa scena scritta come testo.

Prima-dopo e transizioni

Invia last_image_url insieme a image_url e la ripresa dovrà atterrare sul fotogramma finale. L’esempio pubblicato arreda in dieci secondi una stanza vuota con un tappeto, un divano e delle lampade, a camera fissa: la forma di una rivelazione dopo una ristrutturazione o della trasformazione di un prodotto.

Bozze a 480p, consegna a 720p

Fai passate economiche a 480p finché azione e inquadratura funzionano, poi ripeti la stessa richiesta a 720p per la ripresa che tieni. La risoluzione cambia solo il formato consegnato; non aggiunge dettagli che il primo fotogramma non abbia già.

# 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/image-to-video",
  "input": {
    "aspect_ratio": "adaptive",
    "bitrate_mode": "standard",
    "duration_seconds": 5,
    "generate_audio": true,
    "image_url": "https://example.com/reference.png",
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise"
  }
}'

# 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.