Wan 2.5 API
Wan 2.5 de Alibaba: texto a vídeo e imagen a vídeo de hasta 1080p con audio sincronizado, además de video-extend, image-edit y text-to-image en la misma familia, con variantes Fast de los endpoints de vídeo.
Esta guía de la API de Wan 2.5 cubre los endpoints activos en WaveSpeedAI: texto a vídeo, imagen a vídeo y video-extend con variantes Fast, image-edit y text-to-image. El Playground, los ejemplos, los precios y los ejemplos de API de más abajo usan los endpoints activos de Wan 2.5.
Resumen
Acerca de Wan 2.5 API
Qué hace Wan 2.5, cómo encaja en la gama de modelos de Alibaba y por qué los equipos lo eligen.
Wan 2.5 es un modelo de generación de vídeo de Alibaba, disponible a través de la API REST de WaveSpeedAI. Wan 2.5 de Alibaba: texto a vídeo e imagen a vídeo de hasta 1080p con audio sincronizado, además de video-extend, image-edit y text-to-image en la misma familia, con variantes Fast de los endpoints de vídeo.
Esta guía de la API de Wan 2.5 cubre los endpoints activos en WaveSpeedAI: texto a vídeo, imagen a vídeo y video-extend con variantes Fast, image-edit y text-to-image. El Playground, los ejemplos, los precios y los ejemplos de API de más abajo usan los endpoints activos de Wan 2.5.
La familia Wan 2.5 en WaveSpeedAI incluye 8 endpoints REST que cubren los flujos de trabajo de Image-To-Image, Text-To-Image, Video-Extend, Text-To-Video, Image-To-Video. Cada variante tiene su propio precio, parámetros y ejemplos de resultados: elige la que se ajuste a tu modalidad de entrada y a tus requisitos de producción, o llama a varias con la misma clave de API para componer flujos de varios pasos.
Ejecuta Wan 2.5 con la misma clave de API, la misma cuenta de facturación y los mismos límites de uso que ya usas para los demás más de 1.000 modelos de IA de WaveSpeedAI. Sin configuración aparte por proveedor, sin SDK por proveedor, sin límites de uso distintos por proveedor: una sola integración lo cubre todo, desde texto a imagen y texto a vídeo hasta síntesis de audio, generación 3D, escalado y edición.
Especificaciones
Capacidades y estado de lanzamiento de Wan 2.5 API
Los detalles específicos del modelo que los desarrolladores buscan antes de elegir una API: disponibilidad, duración esperada del resultado, compatibilidad con referencias y la alternativa en producción actual.
Disponibilidad
Disponible ahora
Los endpoints de Wan 2.5 están activos en el catálogo de WaveSpeedAI: texto a vídeo, imagen a vídeo y video-extend (cada uno con variante Fast), image-edit y text-to-image, todos con el mismo flujo de predicción REST.
Resoluciones
480p, 720p, 1080p
La salida de vídeo está disponible en 480p, 720p y 1080p según el endpoint; texto a vídeo ofrece tamaños horizontales y verticales en cada una.
Duración
3 a 10 segundos
Texto a vídeo genera clips de 5 o 10 segundos; imagen a vídeo Fast y video-extend generan de 3 a 10 segundos.
Audio
Audio sincronizado
Los endpoints de vídeo generan audio sincronizado con la imagen, y un archivo de audio opcional (WAV o MP3, de al menos 3 segundos y hasta 15 MB) puede orientar la generación.
Variantes Fast
Texto, imagen y ampliación
Wan 2.5 Fast está disponible para texto a vídeo, imagen a vídeo y video-extend, pensado para una generación más rápida y asequible.
Herramientas de imagen
Edición y text-to-image
image-edit admite hasta dos imágenes de entrada con un prompt, y text-to-image genera imágenes fijas en la misma familia que los endpoints de vídeo.
Endpoints
Todos los endpoints de la API de Wan 2.5
8 endpoints de Wan 2.5 disponibles ahora en WaveSpeedAI: elige la variante que se ajuste a tu flujo de trabajo.
/filters:quality(82)/media/images/20260408104220_jymu91ex.webp)
Wan 2.5 Image Edit
Refine existing visuals with WAN 2.5 image-edit using prompt-driven adjustments and stylistic upgrades for photos and graphics. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104211_97h9m7p7.webp)
Wan 2.5 Text To Image
WAN 2.5 Text-to-Image turns text prompts into AI-generated images with the WAN 2.5 model for on-demand image creation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104203_64hpvi1b.webp)
Wan 2.5 Video Extend Fast
WAN 2.5 Fast is an AI-powered video extender that turns short clips into longer videos while preserving audio tracks for seamless extensions. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104158_jzbs7q2h.webp)
Wan 2.5 Video Extend
WAN 2.5 Video-Extend turns short clips into longer videos with preserved or generated synchronized audio for continuity. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104214_334vajy7.webp)
Wan 2.5 Text To Video
WAN 2.5 makes 480p-1080p text/image-to-video with synced audio and is faster, more affordable than Google Veo3. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104222_y5iz96kb.webp)
Wan 2.5 Text To Video Fast
WAN 2.5 Fast creates synchronized-audio videos from text or images in 720p, faster and more affordable than Google Veo3. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104205_99s4gqxu.webp)
Wan 2.5 Image To Video Fast
WAN 2.5 Fast converts text or images into synchronized-audio videos in 480p, 720p, or 1080p, offering faster, more affordable generation compared to Google Veo3. REST API, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104159_4c1hr4ym.webp)
Wan 2.5 Image To Video
WAN 2.5 converts text or images into videos (480p/720p/1080p) with synced audio, faster and more affordable than Google Veo3. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Ejemplos
Mira Wan 2.5 en acción
Resultados reales generados con la API de Wan 2.5. Pasa el cursor sobre cualquier vídeo para previsualizarlo y haz clic para abrir el visor a tamaño completo.
Cómo empezar
Cómo usar la API de Wan 2.5
Cuatro pasos desde el registro hasta una generación terminada. Encontrarás ejemplos completos en Python, Node.js y cURL en la sección de API más abajo.
- 01
Obtén una clave de API
Regístrate en WaveSpeedAI y copia tu clave de API desde el panel. Las cuentas nuevas incluyen créditos gratuitos para empezar: suficientes para usar el playground unas decenas de veces antes de que empiece la facturación.
- 02
Envía una predicción
Haz POST de tu entrada como JSON a https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video. El endpoint devuelve un id de predicción de inmediato: las generaciones son asíncronas, así que no mantienes una conexión abierta durante la inferencia.
- 03
Consulta hasta que termine
Haz GET a https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Devuelve los resultados con completed; detente con un error en failed, cancelled, timeout o deleted; sigue consultando con cualquier otro estado.
- 04
Lee la URL del resultado
Cuando status sea "completed", lee la URL de data.outputs[0]. La URL apunta a tu contenido generado en la CDN de WaveSpeedAI: imagen, vídeo, audio o archivo 3D según la variante de Wan 2.5 que hayas llamado.
Casos de uso
Qué puedes crear con Wan 2.5
Flujos de trabajo habituales para los que desarrolladores y creadores usan la API de Wan 2.5.
Texto a vídeo con audio sincronizado
alibaba/wan-2.5/text-to-video convierte un prompt en un clip de 5 o 10 segundos de hasta 1080p, con audio generado junto con la imagen.
Imagen a vídeo a partir de una imagen fija
alibaba/wan-2.5/image-to-video y la variante Fast animan una imagen de referencia con un prompt, en 720p o 1080p y de 3 a 10 segundos en el endpoint Fast.
Ampliar un clip
alibaba/wan-2.5/video-extend continúa un vídeo existente con audio sincronizado conservado o generado, en 480p, 720p o 1080p, y la variante Fast hace lo mismo a menor coste.
Guía un clip con tu propio audio
Pasa un archivo de audio a los endpoints de vídeo para orientar la generación, por ejemplo una línea de voz o un ritmo que el movimiento deba seguir.
Edita imágenes en la misma familia
alibaba/wan-2.5/image-edit aplica ediciones guiadas por prompt a una o dos imágenes, de modo que las imágenes fijas y los clips salen de una misma familia de modelos.
Imágenes fijas con text-to-image
alibaba/wan-2.5/text-to-image genera imágenes a partir de un prompt, con el tamaño definido en píxeles hasta 2880.
Consejos
Consejos para escribir prompts en Wan 2.5
Consejos prácticos para obtener mejores resultados con Wan 2.5, basados en los patrones que funcionan en modelos de vídeo en flujos de producción.
- 01
Prototipa en Fast, entrega en el endpoint estándar
Usa las variantes Fast para probar prompts y movimiento, y luego ejecuta el endpoint estándar para el clip final.
- 02
Elige el tamaño según la plataforma
Texto a vídeo ofrece tamaños horizontales y verticales en 480p, 720p y 1080p, así que elige el tamaño según dónde se reproducirá el clip antes de generar.
- 03
Usa el audio para marcar el ritmo
Un WAV o MP3 corto de al menos 3 segundos puede orientar la generación, lo que ayuda cuando el movimiento debe seguir una línea de voz o un ritmo.
- 04
Amplía en pasos pequeños
Con video-extend, continúa un clip unos pocos segundos cada vez y describe lo que ocurre a continuación, para que cada paso mantenga la escena y el audio continuos.
Precios
Precios de la API de Wan 2.5
El precio es por resultado. El cargo final depende de los parámetros que definas en el playground de cada variante (resolución, duración, número de resultados, referencias).
| Endpoint | Tipo | Precio inicial |
|---|---|---|
| alibaba/ | image-to-image | $0.035 |
| alibaba/ | text-to-image | $0.03 |
| alibaba/ | video-extend | $0.068 |
| alibaba/ | video-extend | $0.10 |
| alibaba/ | text-to-video | $0.10 |
| alibaba/ | text-to-video | $0.068 |
| alibaba/ | image-to-video | $0.068 |
| alibaba/ | image-to-video | $0.10 |
API
Llama a la API de Wan 2.5
Obtén una clave de API en wavespeed.ai/accesskey y envía una predicción por REST. El playground genera ejemplos listos para pegar con cualquier combinación de entradas.
POSThttps://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"size": "1280*720",
"duration": 5,
"enable_prompt_expansion": false
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"size": "1280*720",
"duration": 5,
"enable_prompt_expansion": false
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"size": "1280*720",
"duration": 5,
"enable_prompt_expansion": False
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)Comparar
Wan 2.5 frente a las alternativas
Cuándo elegir Wan 2.5 en lugar de modelos similares en WaveSpeedAI.
Wan 2.5 frente a Wan 2.7
Wan 2.7 es la generación más reciente, con reference-to-video, video-edit y salida 1080p en más endpoints. Wan 2.5 sigue siendo una opción con variantes Fast y audio sincronizado.
Wan 2.5 frente a Veo 3.1
El catálogo presenta Wan 2.5 como más rápido y más asequible que Google Veo 3, con generación guiada por audio y video-extend. Veo 3.1 ofrece los niveles Standard, Fast y Lite en 1080p.
Wan 2.5 frente a Kling 2.6
Kling 2.6 añade control de movimiento y un endpoint create-voice. Wan 2.5 cubre de 480p a 1080p con audio sincronizado, video-extend, image-edit y text-to-image en una sola familia.
Preguntas frecuentes
Wan 2.5 API — Preguntas frecuentes
Precios, licencia, integración: preguntas habituales sobre cómo ejecutar Wan 2.5 en WaveSpeedAI.
¿Qué resoluciones admite Wan 2.5?
Los endpoints de vídeo generan 480p, 720p y 1080p según el endpoint. Texto a vídeo ofrece además tamaños verticales, y imagen a vídeo Fast genera 720p o 1080p.
¿Wan 2.5 genera audio?
Sí. Los endpoints de vídeo producen audio sincronizado con la imagen, y puedes enviar un archivo de audio opcional para orientar el resultado.
¿Qué es Wan 2.5 Fast?
Variantes Fast de texto a vídeo, imagen a vídeo y video-extend, pensadas para una generación más rápida y asequible que las variantes estándar.
¿Puedo ampliar un vídeo existente con Wan 2.5?
Sí. El endpoint video-extend continúa un clip corto hasta convertirlo en uno más largo, con audio sincronizado conservado o generado, y tiene una variante Fast.
¿Qué es la API de Wan 2.5?
Wan 2.5 es un modelo de generación de vídeo de Alibaba expuesto como API REST en WaveSpeedAI. Wan 2.5 de Alibaba: texto a vídeo e imagen a vídeo de hasta 1080p con audio sincronizado, además de video-extend, image-edit y text-to-image en la misma familia, con variantes Fast de los endpoints de vídeo. Puedes llamarlo por programación o probarlo desde el playground enlazado arriba.
¿Cómo llamo a la API de Wan 2.5?
Regístrate en WaveSpeedAI, copia tu clave de API desde /accesskey y haz POST a https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video con tu entrada como JSON. El endpoint devuelve un id de predicción. Consulta el endpoint de resultados aproximadamente cada 2 segundos, aumenta el intervalo en las tareas largas y detente ante cualquier estado final. Arriba tienes ejemplos en Python / Node.js / cURL orientados a producción.
¿Cuánto cuesta la API de Wan 2.5?
Wan 2.5 empieza en $0.03 por ejecución. El coste exacto depende de los parámetros que definas (resolución, duración, número de resultados, referencias). La vista previa del coste en tiempo real junto al botón Generar del playground muestra el precio exacto de tu entrada actual.
¿Qué variantes de Wan 2.5 hay disponibles?
WaveSpeedAI aloja 8 endpoints de Wan 2.5 en producción: alibaba/wan-2.5/image-edit, alibaba/wan-2.5/text-to-image, alibaba/wan-2.5/video-extend-fast, alibaba/wan-2.5/video-extend, alibaba/wan-2.5/text-to-video, alibaba/wan-2.5/text-to-video-fast, alibaba/wan-2.5/image-to-video-fast, alibaba/wan-2.5/image-to-video. Cada variante tiene su propia página de playground y sus propios precios.
¿Puedo usar comercialmente los resultados de Wan 2.5?
Los derechos de uso comercial dependen de la licencia del modelo de Alibaba. La mayoría de los modelos de Alibaba permiten el uso comercial de los resultados; consulta la página del playground de cada modelo para ver el resumen de su licencia y los Términos del servicio de WaveSpeedAI para las condiciones de la plataforma.
¿Por qué usar Wan 2.5 en WaveSpeedAI en lugar de ir directamente al proveedor?
Una sola clave de API y una sola cuenta de facturación para Wan 2.5 Y más de 1.000 modelos de IA de otros proveedores. Sin configurar un SDK por proveedor, sin límites de uso aparte y sin reescribir el código de integración para cada proveedor. Los precios suelen ser iguales o inferiores a los de la API directa de Alibaba.
Proveedor
Acerca de Alibaba
El equipo detrás de Wan 2.5 y de la gama más amplia de modelos de Alibaba en WaveSpeedAI.
Tongyi Lab, de Alibaba, produce la familia de modelos de vídeo Wan y la familia de LLM Qwen. Wan destaca por publicarse con pesos abiertos, por su amplia cobertura de variantes (texto a vídeo, imagen a vídeo, referencia a vídeo, edición de vídeo, extensión de vídeo, edición de imagen, texto a imagen) y por su solidez constante en estabilidad del movimiento y fidelidad al prompt con prompts multilingües.
Empieza a crear con Wan 2.5 en WaveSpeedAI
Créditos gratuitos al registrarte. Una sola clave de API para más de 1.000 modelos de IA de Alibaba y de todos los demás proveedores.