API Seedance 2.0 Mini Spicy: video NSFW senza censura

bytedance/seedance-2.0-mini-spicy/image-to-video

Seedance 2.0 Mini Spicy è il modello image-to-video senza censura di ByteDance nella fascia Mini, che anima un’immagine fissa fornita come primo fotogramma. Clip da 4 a 15 secondi a 480p o 720p con audio nello stesso passaggio; serve solo l’immagine.

Da $0.039/s

Esegui il modello Vedi l’API

Invia una richiesta

Gli esempi usano le definizioni pubbliche dei parametri dell’endpoint selezionato. Sostituisci la chiave API e i media di esempio, poi invia la richiesta dal tuo server.

SDK e integrazioni

POSThttps://api.spicyapi.ai/api/v1/jobs/createTask

Autenticazione dell’API

Tieni la chiave API nella variabile d’ambiente del server SPICY_API_KEY. Per le richieste JSON usa l’autenticazione Bearer e Content-Type: application/json.

Authorization: Bearer $SPICY_API_KEY

Risultato di esempio

# 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-spicy/image-to-video",
  "input": {
    "aspect_ratio": "adaptive",
    "duration_seconds": 5,
    "generate_audio": true,
    "image_url": "https://example.com/reference.png",
    "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"

Generato dallo schema di input di questo modello, lo stesso su cui l’API valida ogni richiesta.

Parametri di input

Metti questi campi dentro l’oggetto input del corpo della richiesta. Nomi e tipi corrispondono all’API. Quando un valore predefinito non è indicato, non darlo per scontato.

image_urlstringObbligatorio

Obbligatorio, e unico campo obbligatorio. Diventa il primo fotogramma, quindi composizione, somiglianza, abbigliamento, color grade e tetto di qualità vengono tutti da qui – e in una scena buia è anche ciò che tiene scure le ombre. Un'immagine nitida ed esposta correttamente batte qualsiasi rattoppo fatto dopo nel prompt. Ogni lato deve essere compreso tra 300 e 6000 pixel; sotto questa soglia il controllo in ingresso rifiuta l'immagine prima di qualsiasi addebito.

Predefinito: Non specificato
Vincoli: contentMediaType:["image/jpeg","image/png","image/webp","image/gif"]

seedintegerFacoltativo

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. È uno strumento di confronto, non la promessa di ripetizioni identiche fotogramma per fotogramma.

Predefinito: Non specificato
Vincoli: minimum:0
maximum:2147483647

generate_audiobooleanFacoltativo

Decide se viene generata una colonna sonora nativa sincronizzata con le immagini. Attivo per impostazione predefinita; disattivarlo non abbassa la tariffa in questo livello. Spegnilo per i loop muti e per il materiale che sonorizzerai in post.

Predefinito: true

duration_secondsintegerFacoltativoIncide sul prezzo

Durata della clip finita in secondi interi, da 4 a 15, predefinito 5, ed è la quantità fatturata. Una ripresa guidata da un solo fotogramma deriva tanto più quanto più dura, quindi conferma il movimento a 4 o 5 secondi prima di pagarne 15.

Predefinito: 5
Vincoli: minimum:4
maximum:15

resolutionstringFacoltativoIncide sul prezzo

Risoluzione in uscita: 480p, oppure 720p per impostazione predefinita. Seleziona una fascia tariffaria e governa solo il formato consegnato: non aggiunge dettaglio che il primo fotogramma non abbia già. Le fasce più alte significano file più grandi e rendering più lunghi.

Predefinito: "720p"
Valori ammessi: "480p""720p"

aspect_ratiostringFacoltativo

Inquadratura in uscita, adaptive per impostazione predefinita: segue le proporzioni del fotogramma che hai fornito e ti risparmia un ritaglio preventivo. Scegli una proporzione concreta tra 21:9 e 9:16 solo quando il formato di consegna è già fissato. Nessun effetto su quanto ti viene addebitato.

Predefinito: "adaptive"
Valori ammessi: "16:9""9:16""4:3""3:4""1:1""21:9""adaptive"

last_image_urlstringFacoltativo

Ultimo fotogramma facoltativo. Decide l'immagine su cui la ripresa atterra: una transizione, una coppia prima-e-dopo oppure un loop che si apre e si chiude sullo stesso fotogramma. Tieni ferme camera e luce tra i due e cambia un solo stato chiaro, altrimenti il centro della clip diventa uno stacco. Ogni lato deve essere compreso tra 300 e 6000 pixel; sotto questa soglia il controllo in ingresso rifiuta l'immagine prima di qualsiasi addebito.

Predefinito: Non specificato
Vincoli: contentMediaType:["image/jpeg","image/png","image/webp","image/gif"]

promptstringFacoltativo

Qui è facoltativo, ed è proprio questo il punto: il primo fotogramma fissa già che cosa c'è sullo schermo, quindi il prompt deve solo dirigere il movimento – l'azione, una luce che si spegne, la deriva della camera, il suono della stanza. I brief non vengono esaminati da parte nostra, ma il livello interno di Seedance rifiuta una banda ristretta di formulazioni, i baci più di tutto. Metti quel momento nel fotogramma invece che nella frase.

Predefinito: Non specificato

{
  "additionalProperties": false,
  "properties": {
    "aspect_ratio": {
      "default": "adaptive",
      "description": "The aspect ratio of the generated video. Use adaptive to follow the input image.",
      "enum": [
        "16:9",
        "9:16",
        "4:3",
        "3:4",
        "1:1",
        "21:9",
        "adaptive"
      ],
      "type": "string",
      "x-ui": {
        "affects_price": false,
        "order": 970,
        "widget": "select"
      }
    },
    "duration_seconds": {
      "default": 5,
      "description": "The duration of the generated video in seconds (4-15s).",
      "maximum": 15,
      "minimum": 4,
      "type": "integer",
      "x-ui": {
        "advanced": false,
        "affects_price": true,
        "order": 950,
        "unit": "s",
        "widget": "slider"
      }
    },
    "generate_audio": {
      "default": true,
      "description": "Whether to generate native audio synchronized with the output video. Defaults to true.",
      "type": "boolean",
      "x-ui": {
        "advanced": false,
        "affects_price": true,
        "order": 940,
        "widget": "switch"
      }
    },
    "image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "Start image URL to guide the video generation.",
      "type": "string",
      "x-ui": {
        "affects_price": false,
        "order": 1000,
        "widget": "upload"
      }
    },
    "last_image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "Last frame image URL for video continuation.",
      "type": "string",
      "x-ui": {
        "affects_price": false,
        "order": 980,
        "widget": "upload"
      }
    },
    "prompt": {
      "description": "Describe the scene, action, camera movement, and mood for the video.",
      "type": "string",
      "x-ui": {
        "affects_price": false,
        "order": 990,
        "widget": "textarea"
      }
    },
    "resolution": {
      "default": "720p",
      "description": "The output video resolution.",
      "enum": [
        "480p",
        "720p"
      ],
      "type": "string",
      "x-ui": {
        "advanced": false,
        "affects_price": true,
        "order": 960,
        "widget": "radio"
      }
    },
    "seed": {
      "description": "Random seed. Omit to let the model pick one.",
      "maximum": 2147483647,
      "minimum": 0,
      "type": "integer",
      "x-ui": {
        "affects_price": false,
        "order": 930,
        "widget": "number"
      }
    }
  },
  "required": [
    "image_url"
  ],
  "type": "object",
  "x-pricing": {
    "billingMode": "variant_matrix",
    "variantFields": [
      "resolution",
      "generate_audio"
    ]
  }
}

Segui l’attività

HTTP 202 significa che l’attività è stata accettata, non che sia finita. Salva il taskId restituito e interroga quell’attività. Non crearne un’altra mentre aspetti il risultato.

Risposta di accettazione

HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3

{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_create",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued",
    "estimatedCost": "0.750000"
  }
}

La risposta di accettazione include la stima, così la tua applicazione può mostrare lo stesso importo nella cronologia delle attività e nella fatturazione.

Leggi l’attività

curl --get "https://api.spicyapi.ai/api/v1/jobs/recordInfo" \
  --data-urlencode "taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Comincia a interrogare ogni 2 secondi circa e allunga l’intervallo man mano. Fermati a uno stato terminale. Dopo una caduta di connessione, interroga il taskId originale. Ripeti la creazione solo con la chiave di idempotenza e il corpo originali.

Oppure lascia che sia la callback a trovarti

import { verifyWebhook } from "@spicyapi/sdk";

// express.raw keeps the bytes we signed; express.json never matches.
app.post("/hooks/spicy", express.raw({ type: "application/json" }), (req, res) => {
  const { payload } = verifyWebhook({
    rawBody: req.body,
    timestamp: req.header("X-Webhook-Timestamp"),
    signature: req.header("X-Webhook-Signature"),
    payloadVersion: Number(req.header("X-Webhook-Payload-Version")),
    secret: process.env.SPICY_WEBHOOK_SECRET,
  });
  res.status(200).end();
  void handleFinishedTask(payload);
});

Passa callBackUrl quando crei l’attività e il record finito ti arriva via POST: nessun ciclo di polling. Ogni consegna porta X-Webhook-Timestamp, X-Webhook-Signature e X-Webhook-Payload-Version. La firma è un HMAC-SHA256 in base64 su taskId.timestamp.sha256(body), quindi va verificata sui byte grezzi: se analizzi il JSON e lo riserializzi i byte cambiano e la verifica fallisce. Le consegne fallite vengono ritentate, quindi lo stesso taskId può arrivare due volte: rendi idempotente il gestore. Rispondi prima con un 2xx e fai il lavoro dopo; un gestore lento viene trattato come una consegna fallita.

Leggi il risultato

Usa l’output solo quando lo stato è succeeded. In caso di fallimento, indaga con errorCode, errorMessage e request_id. Costi e stati degli esempi non rappresentano un addebito reale.

Esempio di risposta completata

{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_record",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "bytedance/seedance-2.0-mini-spicy/image-to-video",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "key": "tasks/2026/08/28/job_01k3m8x9q2z4v7n5p6r8s0t1w3/3f7a1c9e5b2d48f0a6c1e3d5b7f9a1c3.mp4",
          "mime": "video/mp4",
          "url": "https://example.r2.cloudflarestorage.com/results/job_01k3m8x9q2z4v7n5p6r8s0t1w3/result.mp4?X-Amz-Signature=SIGNATURE_FROM_RESPONSE",
          "expiresAt": "2026-08-28T12:20:08.000Z"
        }
      ]
    },
    "cost": "0.750000",
    "settled": true,
    "createdAt": "2026-08-28T12:00:00Z",
    "completedAt": "2026-08-28T12:00:30Z"
  }
}

Per ogni asset disponibile, apri o scarica assets[].url direttamente, senza l’header Authorization dell’API. L’URL firmato scade a expiresAt; interroga di nuovo l’attività per rinnovarlo finché l’asset resta entro il periodo di conservazione. Un asset in attesa o non disponibile non ha URL. Tratta gli URL firmati come privati.

SDK e integrazioni

Usa SpicyAPI nella tua app, nel terminale, con un assistente IA o in un workflow visivo. Scegli una guida di configurazione.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Comandi da terminale e script di automazione.

MCP

Claude Code · Cursor · Codex

Agent Skill

Istruzioni riutilizzabili per il tuo assistente IA.

n8n

Nodi della community per installazioni self-hosted e template HTTP Request importabili per n8n Cloud.

ComfyUI

Workflow di immagini, video e audio su una tela a nodi.

Altre integrazioni

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

Esplora i workflow pronti all’uso

Non sei obbligato a scrivere niente del codice qui sopra. Collega una volta il server MCP e qualsiasi agente che parla MCP – Claude Code, Codex, Cursor, Windsurf, VS Code, Gemini CLI, Cline, LibreChat – può eseguire questo modello chiamandolo per nome, oppure lo esegui dalla shell con un solo comando.

Chiedi questo al tuo agente

Usa bytedance/seedance-2.0-mini-spicy/image-to-video per animare ./poster.png – carrellata lenta in avanti, cinque secondi – e salva la clip lì accanto.

L’agente cerca il modello nel catalogo in tempo reale, carica per te il file locale, poi mostra il preventivo esatto con l’addebito massimo e aspetta la tua conferma. Niente viene addebitato finché non dici di sì.

Collegalo una volta sola

claude mcp add spicyapi -e SPICY_API_KEY=$SPICY_API_KEY \
  -- npx --yes --package=@spicyapi/mcp spicyapi-mcp
npx skills add spicyapi-ai/spicy-skill

La prima riga dà gli strumenti all’agente; la seconda gli dà la Skill, cioè le regole con cui usarli: preventivare prima di addebitare, caricare i file locali invece di incollarne i byte, leggere l’URL dell’asset finito invece di indovinarlo. Tutti gli altri client prendono lo stesso server dal proprio file di configurazione: vedi l’area sviluppatori.

Oppure un comando nella tua shell

npx @spicyapi/cli tasks create --model bytedance/seedance-2.0-mini-spicy/image-to-video \
  --input-json '{"aspect_ratio":"adaptive","duration_seconds":5,"generate_audio":true,"image_url":"https://example.com/reference.png","resolution":"720p"}' \
  --wait

L’input è lo schema di questo endpoint, lo stesso degli esempi qui sopra. --wait interroga finché l’attività non è finita e poi la stampa; aggiungi --yes per saltare la richiesta di conferma in CI. Imposta prima SPICY_API_KEY: una sola chiave vale per l’API, per la CLI e per il server MCP.

File locali

npx @spicyapi/cli files upload ./poster.png
# -> spicy://uploads/01k3m8x9q2z4v7n5p6r8s0t1w3

npx @spicyapi/cli tasks create --model bytedance/seedance-2.0-mini-spicy/image-to-video \
  --input-json '{"image_url":"spicy://uploads/01k3m8x9q2z4v7n5p6r8s0t1w3"}' \
  --wait

I corpi delle richieste vogliono URL, non byte. Carica prima il file e passa l’URI spicy:// che viene stampato: il nome del campo qui sopra è quello di questo endpoint, preso dal suo schema. Un agente su MCP fa questo passaggio al posto tuo, ed è per questo che la frase più in alto può nominare direttamente ./poster.png. I media già raggiungibili via HTTPS pubblico non vanno caricati.

Per quanto restano i risultati

npx @spicyapi/cli tasks create --model bytedance/seedance-2.0-mini-spicy/image-to-video \
  --input-json '{…}' --retention 1h --wait

npx @spicyapi/cli tasks get $TASK_ID   # read back the retention that applied

--retention può solo accorciare la finestra: 30m, 1h, 7d, oppure 0 per cancellare appena l’attività raggiunge uno stato terminale. Il valore che vale davvero è il più corto fra la tua richiesta, le impostazioni del tuo account e il massimo di piattaforma, quindi rileggilo dal record dell’attività invece di dare per scontato il numero che hai chiesto. Passare una finestra più lunga di quanto consente il tuo account non ha nessun effetto.

Usalo in ComfyUI

Installa i nodi SpicyAPI da ComfyUI Manager o con il comando qui sotto, poi cerca Seedance 2.0 Mini Spicy · Image to Video sulla tela. Il nodo ha le stesse opzioni di questa pagina e mostra il prezzo prima dell’esecuzione.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

Esempi di workflow Guida all’installazione Codice sorgente su GitHub

Il pannello incorporato legge lo stesso schema di questa pagina, quindi non può discostarsi dall’API. Se nella tua documentazione i contenuti devono essere ricercabili, leggi il JSON sotto /api/embed/models/ e renderizzalo per conto tuo.

<iframe src="https://spicyapi.ai/embed/it/models/seedance-2-0-mini-spicy/api?model=bytedance%2Fseedance-2.0-mini-spicy%2Fimage-to-video" width="100%" height="560" loading="lazy" title="Esempio di richiesta" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Apri il pannello

Playground

Invia una richiesta

Autenticazione dell’API

Parametri di input

Segui l’attività

Leggi il risultato

SDK e integrazioni

Usalo in ComfyUI