Vai al contenuto principale

Senza censura — Questo modello dichiara di non applicare alcun filtro sui contenuti. SpicyAPI inoltra la richiesta senza aggiungere controlli di piattaforma; gli obblighi di legge e la verifica del consenso restano a carico del cliente.Vedi tutti i modelli con questo livello di filtraggio
alibaba/wan-2.6-flash/reference-to-video

Wan 2.6 Flash Riferimenti in video di Alibaba porta persone, animali o oggetti da un massimo di cinque immagini fisse e clip dentro una scena nuova descritta dal prompt, sul livello Flash, più veloce ed economico. Le clip durano da 2 a 10 secondi a 720p o 1080p, mute per impostazione predefinita oppure con una colonna sonora generata.

Da $0.022/s10% sotto il prezzo di listino del produttore del modello
Esegui il modello

Playground

Invia una richiesta

Guida rapida

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 esempioUsa questo 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": "alibaba/wan-2.6-flash/reference-to-video",
  "input": {
    "aspect_ratio": "16:9",
    "duration_seconds": 5,
    "generate_audio": false,
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "720p",
    "shot_type": "single",
    "reference_video_urls": [
      "https://example.com/reference.mp4"
    ]
  }
}'

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

Questo modello ha dipendenze tra i campi. I campi segnati come obbligatori a certe condizioni dipendono da altri input; le regole sono nel JSON Schema completo qui sotto.

promptstringObbligatorio

La scena nuova: chiama ogni riferimento character1, character2 e così via, prima le clip e poi le immagini fisse, e di’ cosa fa ciascuno, poi ambientazione, camera e luce. Fino a 1.500 caratteri. Con generate_audio attivo, descrivi dopo l’azione i suoni che vuoi.

Predefinito
Non specificato
Vincoli
minLength:1
maxLength:1500
seedintegerFacoltativo

Da 0 a 2147483647. Tienilo fermo mentre cambi un riferimento alla volta, così l’estrazione casuale resta costante e si muove solo ciò che hai cambiato. È uno strumento di confronto, non una garanzia di riesecuzione identica fotogramma per fotogramma.

Predefinito
Non specificato
Vincoli
minimum:0
maximum:2147483647
enable_prompt_expansionbooleanFacoltativo

Disattivata per impostazione predefinita. Attivandola, un’idea di una riga diventa un brief più completo prima della generazione; lasciala spenta quando il prompt indica già con precisione il cast e l’inquadratura. Con shot_type su multi viene attivata a prescindere da questa impostazione.

Predefinito
false
shot_typestringFacoltativo

single tiene una ripresa continua; multi lascia che il modello stacchi fra inquadrature dentro la stessa scena, adatto a una scena con un ritmo. Su 2 o 3 secondi c’è raramente spazio per uno stacco. Scegliere multi attiva anche enable_prompt_expansion per quella richiesta.

Predefinito
"single"
Valori ammessi
"single""multi"
duration_secondsintegerFacoltativoIncide sul prezzo

Un numero intero qualsiasi da 2 a 10, predefinito 5. È ciò che muove di più il prezzo ed è anche il punto in cui la somiglianza scivola: controlla l’ultimo secondo di una clip lunga prima di impegnarti su quella durata.

Predefinito
5
Vincoli
minimum:2
maximum:10
resolutionstringFacoltativoIncide sul prezzo

720p o 1080p, predefinita 720p. Fissa la tariffa al secondo e quanto dura il task, ed entrambe le risoluzioni accettano tutti e cinque i formati.

Predefinito
"720p"
Valori ammessi
"720p""1080p"
generate_audiobooleanFacoltativoIncide sul prezzo

Disattivato per impostazione predefinita, quindi la clip torna con le sole immagini. Attivo, la clip torna con una traccia audio generata di voci, effetti e atmosfera, e la tariffa al secondo raddoppia a entrambe le risoluzioni.

Predefinito
false
aspect_ratiostringFacoltativo

16:9, 9:16, 1:1, 4:3 o 3:4, predefinito 16:9, disponibile a entrambe le risoluzioni. Si sceglie a ogni richiesta e non si eredita da un riferimento, così uno stesso insieme di riferimenti può essere consegnato in più formati.

Predefinito
"16:9"
Valori ammessi
"16:9""9:16""1:1""4:3""3:4"
reference_image_urlsarray<string>Obbligatorio a certe condizioni

Fino a cinque immagini fisse di persone, animali o oggetti da mettere in scena, insieme alle clip o al loro posto; sommate alle clip, una richiesta accetta al massimo cinque riferimenti. Vengono numerate dopo le clip: senza clip la prima immagine è character1, con due clip è character3. JPEG, PNG senza trasparenza, BMP o WEBP, da 240 a 8.000 pixel per lato e fino a 20 MB. Le immagini fisse non vengono addebitate.

Predefinito
Non specificato
Vincoli
minItems:1
maxItems:5
reference_video_urlsarray<string>Obbligatorio a certe condizioniIncide sul prezzo

Fino a tre clip brevi dei soggetti o dei luoghi da mettere in scena, per un totale di al massimo cinque secondi. Vengono numerate per prime, come character1, character2 e character3 nell’ordine di caricamento. Una clip porta movimento e luogo meglio di un’immagine fissa; i suoi secondi vengono fatturati insieme all’uscita, arrotondati per eccesso e di almeno un secondo ciascuna, quindi taglia prima di caricare. MP4 o MOV.

Predefinito
Non specificato
Vincoli
minItems:1
maxItems:3
negative_promptstringFacoltativo

Ciò che non deve comparire: persone in più, sottotitoli, un oggetto di scena di un riferimento che non vuoi riportare. Al massimo 500 caratteri.

Predefinito
Non specificato
Vincoli
maxLength:500

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": "alibaba/wan-2.6-flash/reference-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

SillyTavernTelegram / DiscordApp proxyOpenAI SDKLangChainVercel AI SDK
Esplora i workflow pronti all’uso

Usalo in ComfyUI

Installa i nodi SpicyAPI da ComfyUI Manager o con il comando qui sotto, poi cerca Wan 2.6 Flash · Reference 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 workflowGuida all’installazioneCodice sorgente su GitHub