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-3.0/reference-to-video

Il reference-to-video Wan 3.0 di Alibaba mantiene coerenti identità, abiti, luogo o voce con fino a 10 immagini, 5 video e 5 file audio. Restituisce 2–30 secondi da 480p a 1080p e il prompt è facoltativo.

Da $0.045/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-3.0/reference-to-video",
  "input": {
    "aspect_ratio": "16:9",
    "duration_seconds": 5,
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "reference_image_urls": [
      "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.

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.

seedintegerFacoltativo

Da 0 a 2147483647. Tienilo fisso per confrontare un campo modificato alla volta; toglilo quando vuoi varietà.

Predefinito
Non specificato
Vincoli
minimum:0
maximum:2147483647
enable_prompt_expansionbooleanFacoltativo

Disattivato per impostazione predefinita. Quando è attivo, il prompt viene riscritto prima della generazione: aiuta i brief scarni e ti ostacola su quelli dettagliati. Se non lo imposti e alleghi reference_file_url o reference_link_url, si attiva per quella richiesta, perché il documento o la pagina vengono letti in questo passaggio. Se lo imposti esplicitamente a false, il file o la pagina vengono letti lo stesso, senza riscrivere il prompt.

Predefinito
Non specificato
generate_audiobooleanFacoltativo

Attivo per impostazione predefinita. Il clip torna con il suono già agganciato all'immagine. Imposta false quando musichi l'inquadratura per conto tuo.

Predefinito
true
duration_secondsintegerFacoltativoIncide sul prezzo

Qualsiasi numero intero da 2 a 30, oppure -1 per la durata intelligente. Il valore predefinito è 5. Con i video di riferimento, la loro durata complessiva più questo valore deve restare entro 30 secondi, e quei secondi vengono fatturati in aggiunta all'output. Metti a punto l'estetica a 5 secondi prima di allungare.

Predefinito
5
Valori ammessi
-123456789101112131415161718192021222324252627282930
resolutionstringFacoltativoIncide sul prezzo

480p, 720p o 1080p. Il valore predefinito è 720p. La risoluzione cambia sia il prezzo sia il tempo che l'attività impiega a tornare.

Predefinito
"720p"
Valori ammessi
"480p""720p""1080p"
enable_thinkingbooleanFacoltativo

Fa ragionare il modello sulla richiesta e sul materiale di riferimento prima di generare. Aiuta con documenti corposi, pagine web e immagini di riferimento complesse, e rende l’esecuzione più lenta. Disattivato per impostazione predefinita; si attiva da solo quando passi un file o un link di riferimento. Non cambia il prezzo.

Predefinito
false
aspect_ratiostringFacoltativo

16:9, 9:16, 1:1, 4:3, 3:4 oppure adaptive, che lascia scegliere al modello. Il valore predefinito è 16:9.

Predefinito
"16:9"
Valori ammessi
"16:9""9:16""1:1""4:3""3:4""adaptive"
reference_link_urlstringObbligatorio a certe condizioni

Una pagina web pubblica che il modello legge come riferimento, per esempio un articolo, una pagina prodotto o un profilo del personaggio. Deve aprirsi senza login. Alcuni siti bloccano i lettori automatici e una pagina con troppo poco testo non si può usare; in entrambi i casi il task fallisce con un messaggio che dice che l’URL non è leggibile, e i task falliti non si pagano. Non insieme a reference_file_url; se non imposti enable_prompt_expansion, anche allegare un link attiva l’espansione del prompt. I link non si pagano.

Predefinito
Non specificato
Vincoli
format:"uri"
reference_file_urlstringObbligatorio a certe condizioni

Un documento che il modello legge prima di dirigere l’inquadratura: una scheda personaggio, una sceneggiatura, una lista di inquadrature o un brief di prodotto. PDF, DOCX, DOC, TXT, MD, PPTX, PPT, XLSX, XLS, KEY, PAGES o NUMBERS, fino a 100 MB e 50 pagine. Funziona da solo o insieme a immagini, video e audio di riferimento, ma non insieme a reference_link_url. Se non imposti enable_prompt_expansion, allegare un file attiva l’espansione del prompt per quella richiesta, perché il documento viene letto in quel passaggio. I file non si pagano.

Predefinito
Non specificato
Vincoli
format:"uri"
contentMediaType:["application/pdf","application/msword","application/vnd.openxmlformats-officedocument.wordprocessingml.document","application/vnd.ms-excel","application/vnd.openxmlformats-officedocument.spreadsheetml.sheet","application/vnd.ms-powerpoint","application/vnd.openxmlformats-officedocument.presentationml.presentation","application/vnd.apple.keynote","application/vnd.apple.pages","application/vnd.apple.numbers","text/plain","text/markdown"]
reference_audio_urlsarray<string>Obbligatorio a certe condizioni

Fino a 5 clip, ciascuno da 1 a 15 secondi e 15 secondi in totale: una voce, una battuta recitata o il tono d'ambiente a cui l'inquadratura deve adeguarsi. L'audio di riferimento non viene fatturato. WAV o MP3, 15 MB per clip. Come per i video, questi limiti vengono verificati durante la generazione e non quando il task viene accettato.

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

Fino a 5 clip, ciascuno da 1 a 15 secondi e 15 secondi in totale. Usali per il movimento e lo stile di camera, non per un volto. La loro durata viene fatturata insieme all'output, e video di riferimento più output devono restare entro i 30 secondi. MP4 o MOV, almeno 16 fps, da 240 a 4096 px per lato, rapporto d'aspetto non oltre 8:1, 100 MB per clip. Questi limiti vengono verificati durante la generazione e non quando il task viene accettato, quindi controlla la durata dei clip prima dell'invio.

Predefinito
Non specificato
Vincoli
minItems:1
maxItems:5
reference_image_urlsarray<string>Obbligatorio a certe condizioni

Da 1 a 10 immagini come tavole di riferimento per identità, guardaroba e set. Indica ciascuna nel prompt – personaggio, capo, set – altrimenti vengono mediate tra loro. Le immagini di riferimento non vengono fatturate. JPEG, PNG senza trasparenza, BMP o WEBP; da 240 a 8000 px per lato, rapporto d'aspetto non oltre 8:1, al massimo 20 MB ciascuna. Il controllo dei volti di questo modello rifiuta spesso le foto di persone reali, e il task fallisce con «The input content is suspected to include real human faces.». Usa invece personaggi illustrati o renderizzati in 3D; i task rifiutati non vengono fatturati.

Predefinito
Non specificato
Vincoli
minItems:1
maxItems:10
promptstringFacoltativo

Opzionale. Quando lo scrivi, dichiara che cosa controlla ogni riferimento, poi descrivi l'inquadratura: soggetto, un'azione, un movimento di camera, luce e suono. Una sola azione chiara sposta il risultato più di un lungo elenco di aggettivi.

Predefinito
Non specificato
Vincoli
minLength:1

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-3.0/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 3.0 · 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