Seedance 2.0 Mini API

Seedance 2.0 Mini 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 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

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.

Un solo set di riferimenti per un’intera serie

Tre viste di un uomo — frontale, di tre quarti e di profilo — più una quarta immagine del suo grembiule possono reggere un’intera serie, mentre tra una richiesta e l’altra cambia solo il prompt. L’esempio pubblicato della panetteria è costruito proprio così.

Il ritmo preso da una clip

Una clip di riferimento può fornire ritmo invece che contenuto. Un esempio riprende da una clip un avanzamento lento e continuo, lo mette in scena lungo una corsia presa da un’immagine di riferimento e fa cadere i passi sul battito di una traccia di riferimento, otto secondi in 9:16.

Una coppia stabile da più angolazioni

Tre immagini della stessa coppia permettono a una nuova ripresa di trovare una terza angolazione mentre volti e abiti restano uguali, come nell’esempio della panchina nel parco generato a 480p.

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