Seedance 1.5 Pro API

Seedance 1.5 Pro immagine in video apre la clip su un’immagine che fornisci tu e la anima fino a 12 secondi. Con camera_fixed attivo, l’inquadratura fornita resta esattamente com’è composta, ed è per questo che questo endpoint produce plate utilizzabili.

ByteDance Seedance 1.5 Pro pubblica due endpoint, testo in video e immagine in video. Entrambi restituiscono clip da 4 a 12 secondi a 480p, 720p o 1080p con audio nativo, ed entrambi hanno l’interruttore camera_fixed.

Scegli la modalità di Seedance 1.5 Pro in base al materiale di partenza

camera_fixed tiene ferma l’inquadratura

Con false, il valore di default, il modello inventa i propri movimenti: una deriva, un avanzamento, un’orbita lenta. Con true la camera si ferma mentre il soggetto continua a muoversi nell’inquadratura. Un’inquadratura bloccata si può tracciare, scontornare, comporre o mettere in loop, e né Seedance 2.0 né 2.5 hanno questo interruttore.

Audio nella stessa passata

generate_audio è true di default e genera ambiente, effetti di movimento e voce sincronizzati con i fotogrammi. Sposta la richiesta su una fascia di prezzo più alta, quindi spegnilo per i loop di prodotto e per le riprese che verranno sonorizzate dopo.

Un limite chiaro

Le clip durano da 4 a 12 secondi interi a 480p, 720p o 1080p, in sei formati fissi con 16:9 di default e senza opzione adattiva. Non c’è un endpoint per i riferimenti; seed è disponibile a 480p e 720p. I lavori che richiedono 4K, riprese più lunghe o un cast da più immagini vanno su Seedance 2.0 o 2.5; ciò che 1.5 Pro conserva è la camera bloccata.

Plate per il compositing

Invia un’immagine già approvata, attiva camera_fixed e la composizione tiene per tutta la clip mentre si muove solo il soggetto. Il risultato si comporta come una ripresa su cavalletto: uno sfondo pulito da scontornare, una superficie stabile su cui tracciare un titolo, una plate che un montatore può inserire in una sequenza reale.

Rotazioni di prodotto e loop

Un’inquadratura fissa con un oggetto che ruota è il caso classico: niente deriva, l’orizzonte resta dritto e l’ultimo fotogramma arriva abbastanza vicino al primo da fare loop. Spegni generate_audio, perché un loop di prodotto non vuole quasi mai il suono ambiente.

Movimento lento dell’ambiente

L’esempio pubblicato sovrappone neve che cade, vapore che sale e acqua su un’unica immagine, con un avanzamento molto lento perché nulla si perda nella velocità della camera. Meteo, fumo e acqua sono proprio i movimenti che una composizione ferma valorizza meglio.

# 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-1.5-pro/image-to-video",
  "input": {
    "aspect_ratio": "16:9",
    "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",
    "resolution": "720p"
  }
}'

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