API de referencia a vídeo de Wan 3 Spicy: solicitud, precio y consulta

Envía imágenes, vídeos o audios autorizados a la API de Wan 3 Spicy, calcula un trabajo de cinco segundos y recupera el resultado asíncrono.

Conclusión principalUsa mode=reference-to-video con al menos un array de referencias. Empieza con una imagen y cinco segundos fijos; revisa el precio de tu cuenta antes de enviar.

Cuándo usar referencias para vídeo

Usa referencias cuando una toma nueva deba conservar el aspecto de un producto, un patrón de movimiento o un sonido sin fijar el primer fotograma. Wan 3 Spicy admite hasta 10 reference_images, 5 reference_videos y 5 reference_audios en el mismo endpoint POST /v1/videos/generations. El modo reference-to-video requiere al menos uno de esos arrays. No lo combines con first_frame ni last_frame, que pertenecen al modo imagen a vídeo.

Empieza con una imagen que poseas o tengas permiso para usar. En una toma sencilla de producto, una sola imagen aprobada es más fácil de evaluar que muchas referencias contradictorias. Da a cada referencia adicional una función clara en el prompt.

Enviar una solicitud de cinco segundos

Confirma el acceso para adultos al modelo Spicy en tu cuenta y configura MODELRUSH_API_KEY en tu servidor. La clave API debe permitir vídeo y acceso a Wan 3 Spicy. Sustituye la URL de ejemplo por una imagen HTTPS accesible que estés autorizado a procesar. Crea una clave de idempotencia una vez y reutilízala si debes repetir el mismo envío por un problema de red.

bash
REQUEST_KEY="$(uuidgen)"
curl -sS https://api.modelrush.ai/v1/videos/generations \
  -H "Authorization: Bearer $MODELRUSH_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $REQUEST_KEY" \
  -d '{
    "model": "modelrush/wan3-spicy",
    "mode": "reference-to-video",
    "prompt": "La botella de cerámica azul de la imagen de referencia está sobre una base de piedra. Una sola toma con un giro lento de cámara en sentido horario y luz cálida lateral.",
    "reference_images": ["https://example.com/approved-bottle.jpg"],
    "duration": 5,
    "resolution": "480P",
    "ratio": "16:9",
    "audio": true
  }'

La API devuelve HTTP 202 con ID de generación, estado queued y poll_url. Guarda la respuesta. Si el cliente agota el tiempo tras el envío, consulta el trabajo guardado o reintenta con la misma clave de idempotencia; no crees otro trabajo directamente.

Consultar el resultado

Copia la ruta relativa poll_url de la respuesta 202 en POLL_URL y consulta el host de la API con la misma clave. Repite con una espera limitada hasta que el endpoint de vídeo indique completed o failed. La respuesta completa incluye video_url; descarga lo que necesites conservar porque la URL puede caducar a las 24 horas.

bash
curl -sS "https://api.modelrush.ai$POLL_URL" \
  -H "Authorization: Bearer $MODELRUSH_API_KEY"

Comprobar duración y precio

Wan 3 Spicy acepta una duración de salida fija de 2 a 30 segundos enteros; si se omite, usa 5 segundos y -1 no está disponible. Los vídeos de referencia pueden sumar como máximo 15 segundos; su duración junto con la salida solicitada no puede superar 30 segundos. El audio de referencia puede sumar hasta 15 segundos. La pasarela valida los archivos antes de enviar la generación.

El 28 de septiembre de 2026, la tarifa pública del Registry para Wan 3 Spicy a 480P era de $0.045 por segundo de salida. La solicitud anterior de cinco segundos con una imagen de referencia tiene un coste estimado de $0.225 a esa tarifa (5 × $0.045). Este ejemplo no incluye un vídeo de referencia. La tarifa de tu cuenta puede variar; consulta el presupuesto de tu cuenta antes de generar. Comprueba el precio actual en la página del modelo Wan 3 Spicy o la página de precios antes de aumentar la resolución o el volumen.

Consulta el esquema completo en la documentación de vídeo. Revisa el modelo Wan 3 Spicy y prueba referencia a vídeo en el Playground.