Ir al contenido principal

Sin censura — Este modelo declara que no aplica filtros. SpicyAPI reenvía sin añadir análisis de contenido de la plataforma; las obligaciones legales y de consentimiento siguen siendo del cliente.Ver todos los modelos con este nivel de filtrado
alibaba/wan-3.0-pro/reference-to-video

El reference-to-video de Wan 3.0 Pro mantiene un rostro, prenda, decorado, movimiento o voz con referencias de imagen, video y audio, más un documento o enlace web opcional. Renderiza 2 a 30 segundos a 1080p, 2K o 4K.

Desde $0.144/s20 % por debajo del precio de lista de referencia
Ejecutar modelo

Playground

Enviar una solicitud

Inicio rápido

Los ejemplos usan las definiciones públicas de parámetros del endpoint seleccionado. Sustituye la clave de API y los medios de ejemplo, y envía la solicitud desde tu servidor.

SDK e integraciones
POSThttps://api.spicyapi.ai/api/v1/jobs/createTask

Autenticación de API

Guarda la clave de API en la variable de entorno del servidor SPICY_API_KEY. Usa autenticación Bearer y Content-Type: application/json en las solicitudes JSON.

Authorization: Bearer $SPICY_API_KEY
Resultado de ejemploUsar este ejemplo
# 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-pro/reference-to-video",
  "input": {
    "aspect_ratio": "adaptive",
    "duration_seconds": 5,
    "reference_image_urls": [
      "https://example.com/reference.png"
    ],
    "resolution": "1080p"
  }
}'

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

Generado a partir del esquema de entrada de este modelo: el mismo con el que la API valida cada solicitud.

Parámetros de entrada

Incluye estos campos en el objeto input del cuerpo de la solicitud. Los nombres y tipos coinciden con la API. No supongas un valor predeterminado si no está indicado.

Este modelo tiene dependencias entre campos. Los marcados como obligatorios según condición dependen de otras entradas; abajo, en el JSON Schema completo, están las reglas.

seedintegerOpcional

De 0 a 2147483647. Déjala fija mientras ajustas resolución o duración; si no, cada repetición cambia dos cosas a la vez.

Valor predeterminado
Sin especificar
Restricciones
minimum:0
maximum:2147483647
enable_prompt_expansionbooleanOpcional

Activa por defecto en esta familia. Rellena briefs flojos y reescribe los detallados, así que desactívala en cuanto tu prompt sea una descripción de plano precisa. Un archivo de referencia o un enlace web lo necesitan activado: déjalo sin definir o en true cuando adjuntes reference_file_url o reference_link_url, porque el documento o la página se leen en este paso. Un false explícito junto con un archivo o un enlace se rechaza.

Valor predeterminado
true
generate_audiobooleanOpcional

Activo por defecto. El sonido se genera con la imagen y llega dentro del mismo archivo. Ponlo en false cuando el anuncio lo musicalice un compositor.

Valor predeterminado
true
duration_secondsintegerOpcionalAfecta al precio

Cualquier número entero de 2 a 30, 5 por defecto, o -1 para la duración inteligente, que reserva el máximo y factura la duración realmente entregada. Con videos de referencia, su duración total más la salida no puede pasar de 30 segundos y se cobran ambas. Encuentra el plano a 5 segundos y 1080p antes de pagar un render largo en 4K.

Valor predeterminado
5
Valores permitidos
-123456789101112131415161718192021222324252627282930
aspect_ratiostringOpcional

16:9, 4:3, 1:1, 3:4, 9:16 o adaptive. Por defecto adaptive, que deja elegir al modelo; nombra una proporción cuando el formato de entrega esté fijado.

Valor predeterminado
"adaptive"
Valores permitidos
"16:9""4:3""1:1""3:4""9:16""adaptive"
resolutionstringOpcionalAfecta al precio

1080p, 2k o 4k, 1080p por defecto. Un render nativo de Wan 3.0 llega como máximo a 1080p, así que los escalones por encima —2k y 4k— se entregan ampliando ese render en lugar de renderizarse de forma nativa a ese tamaño: los píxeles de más salen de la ampliación y nunca son mejores que el render que hay debajo. Aquí no hay escalón de 480p ni de 720p; para esos tamaños, usa Wan 3.0.

Valor predeterminado
"1080p"
Valores permitidos
"1080p""2k""4k"
reference_link_urlstringObligatorio según condición

Una página web pública que el modelo lee como referencia, por ejemplo un artículo, una página de producto o un perfil de personaje. Tiene que abrirse sin iniciar sesión. Algunos sitios bloquean a los lectores automáticos y una página con muy poco texto no sirve; en ambos casos la tarea falla con un mensaje de que no se pudo leer la URL, y las tareas fallidas no se cobran. No se combina con reference_file_url; si no defines enable_prompt_expansion, adjuntar un enlace también activa la expansión del prompt. Los enlaces no se cobran.

Valor predeterminado
Sin especificar
Restricciones
format:"uri"
reference_file_urlstringObligatorio según condición

Un documento que el modelo lee antes de dirigir la toma: una ficha de personaje, un guion, una lista de planos o un brief de producto. PDF, DOCX, DOC, TXT, MD, PPTX, PPT, XLSX, XLS, KEY, PAGES o NUMBERS, hasta 100 MB y 50 páginas. Funciona solo o junto a imágenes, videos y audio de referencia, pero no junto con reference_link_url. Si no defines enable_prompt_expansion, adjuntar un archivo activa la expansión del prompt en esa solicitud, porque el documento se lee en ese paso. Los archivos no se cobran.

Valor predeterminado
Sin especificar
Restricciones
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>Obligatorio según condición

Hasta 5 clips, cada uno de 1 a 15 segundos y 15 segundos en total: una voz, una línea de diálogo o el ambiente de una sala que el plano tenga que respetar. El audio de referencia no se cobra. WAV o MP3, 15 MB por clip. Igual que con el video, estos límites se comprueban durante la generación y no al aceptar la solicitud.

Valor predeterminado
Sin especificar
Restricciones
minItems:1
maxItems:5
reference_video_urlsarray<string>Obligatorio según condiciónAfecta al precio

Hasta 5 clips, cada uno de 1 a 15 segundos y 15 segundos en total. Úsalos para el movimiento y el estilo de cámara, no para una cara. Su duración se cobra junto con la salida, y el video de referencia más la salida no pueden pasar de 30 segundos. MP4 o MOV, al menos 16 fps, de 240 a 4096 px por lado, relación de aspecto de hasta 8:1 y 100 MB por clip. Estos límites se comprueban durante la generación y no al aceptar la solicitud, así que revisa la duración de los clips antes de enviarla.

Valor predeterminado
Sin especificar
Restricciones
minItems:1
maxItems:5
reference_image_urlsarray<string>Obligatorio según condición

De 1 a 10 imágenes como planchas de identidad, vestuario y decorado. Nombra cada una en el prompt —personaje, prenda, decorado— o se promedian entre sí. Las imágenes de referencia no se cobran. JPEG, PNG sin transparencia, BMP o WEBP; de 240 a 8000 px por lado, relación de aspecto de hasta 8:1 y 20 MB por imagen.

Valor predeterminado
Sin especificar
Restricciones
minItems:1
maxItems:10
promptstringOpcional

Opcional, pero es donde dices para qué sirve cada referencia —qué imagen es el personaje, qué clip lleva el movimiento, qué audio es la voz— y qué ocurre de verdad en el plano.

Valor predeterminado
Sin especificar
Restricciones
minLength:1
maxLength:20000

Seguir la tarea

HTTP 202 significa que la tarea se aceptó, no que haya terminado. Guarda el taskId devuelto y consulta esa tarea. No crees otra mientras esperas el resultado.

Solicitud aceptada
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 respuesta de aceptación incluye la estimación para que tu aplicación pueda mostrar el mismo importe en el historial de tareas y en la facturación.

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

Empieza consultando cada 2 segundos aproximadamente y ve espaciando los intentos. Párate en un estado final. Si se cae la conexión, consulta el taskId original. Vuelve a crear la tarea solo con la clave de idempotencia y el cuerpo originales.

O recibe el resultado por callback
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);
});

Pasa callBackUrl al crear la tarea y recibirás el registro terminado por POST, sin un bucle de consultas de estado. Cada entrega lleva X-Webhook-Timestamp, X-Webhook-Signature y X-Webhook-Payload-Version. La firma es un HMAC-SHA256 en base64 sobre taskId.timestamp.sha256(body), así que debes verificarla con los bytes originales: si analizas el JSON y vuelves a serializarlo, los bytes cambian y la verificación falla. Las entregas fallidas se reintentan, de modo que el mismo taskId puede llegar dos veces; haz que tu manejador sea idempotente. Responde 2xx primero y haz el trabajo después: un manejador lento se trata como una entrega fallida.

Leer el resultado

Procesa output solo cuando state sea succeeded. Si falla, consulta errorCode, errorMessage y request_id. Los costos y estados de ejemplo no representan una factura real.

Ejemplo de respuesta completada
{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_record",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "alibaba/wan-3.0-pro/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"
  }
}

Para cada archivo disponible, abre o descarga assets[].url directamente, sin la cabecera Authorization de la API. El enlace firmado expira en expiresAt: vuelve a consultar la tarea para renovarlo mientras el archivo siga dentro del periodo de conservación. Un archivo pendiente o no disponible no trae URL. Trata los enlaces firmados como datos privados.

SDK e integraciones

Usa SpicyAPI en tu app, terminal, asistente de IA o flujo visual. Elige una guía de configuración.

SDKs
TypeScript · Python · Go · PHP · Java
CLI
Comandos de terminal y scripts de automatización.
MCP
Claude Code · Cursor · Codex
Agent Skill
Instrucciones reutilizables para tu asistente de IA.
n8n
Nodos comunitarios para instalaciones propias y plantillas HTTP Request importables para n8n Cloud.
ComfyUI
Flujos de imagen, video y audio en un lienzo de nodos.

Más integraciones

SillyTavernTelegram / DiscordApp proxyOpenAI SDKLangChainVercel AI SDK
Explorar flujos listos para usar

Úsalo en ComfyUI

Instala los nodos de SpicyAPI desde ComfyUI Manager o con el comando de abajo y busca Wan 3.0 Pro · Reference To Video en el lienzo. El nodo tiene las mismas opciones que esta página y muestra su precio antes de ejecutarse.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi
Ejemplos de workflowsGuía de configuraciónCódigo en GitHub