Alibaba

Wan 3.0 Video

wan3.0-video-prime

Nueva generación de modelos de generación de video de la serie Wan de Alibaba, capaz de producir clips de 1080p de unos 30 segundos en una sola pasada, con soporte para mantener la consistencia del sujeto a partir de materiales de referencia y, por primera vez, con soporte para entradas estructuradas de tipo documental

wan3.0-video wan3.0-video-prime

Probar wan3.0-video-prime

Entrada

Salida

video

Rellena los parámetros y genera: los resultados aparecerán aquí.

Precios

wan3.0-video-prime per second

Especificaciones	Precio unitario
480P	$0.0875
720P	$0.180
1080P	$0.360

Descripción general

wan3.0-video-prime es la línea de alta calidad orientada a referencia-a-vídeo (reference-to-video) dentro de la familia Wan 3.0 Video, disponible a través de la interfaz unificada de HiAPI.ai. Acepta materiales de referencia como imágenes, audio, documentos y páginas web y, junto con el prompt, genera vídeos con sonido de hasta 30 segundos y hasta 1080P, además de admitir control de fotograma inicial y final, y selección de duración y relación de aspecto. Es adecuado para desarrolladores y equipos de contenido que necesitan mantener la coherencia del sujeto con materiales de marca o producto y producir piezas finales directamente.

Puntos clave

Generación multimodal impulsada por materiales de referencia: en una sola llamada se pueden combinar hasta 10 imágenes, 5 fragmentos de audio y referencias de documentos o páginas web, que se citan en el prompt como Image1, Audio1, etc., según el orden del array.
Duración de 2 a 30 segundos en una sola generación: el parámetro duration determina directamente la longitud de salida; las narrativas largas no requieren segmentación ni unión para generar un clip completo de una vez.
Hasta 1080P con niveles seleccionables: ofrece tres niveles de resolución (480P, 720P y 1080P) y seis relaciones de aspecto, para sopesar calidad y coste en cada generación.
Pista de audio sincronizada y control de fotograma inicial y final: por defecto la salida incluye audio sincronizado, que también se puede desactivar; junto con las imágenes de fotograma inicial y final se restringen el inicio y el final del plano.

Descripción de capacidades

Generación con coherencia de referencia: fija el sujeto y el estilo mediante materiales de referencia como imágenes y audio, de modo que el mismo personaje o producto mantenga una apariencia coherente durante todo el vídeo y se reduzcan los retrabajos posteriores.

Entrada de materiales estructurada: admite pasar un documento o una página web sin inicio de sesión como referencia y, junto con el prompt, convertir el contenido del material en imágenes de vídeo de tipo explicativo.

Duración y relación de aspecto controlables: duración de 2 a 30 segundos y seis relaciones de aspecto a elegir; adaptive sigue automáticamente los materiales de entrada y el prompt, lo que facilita la adaptación a ubicaciones horizontales, verticales, etc.

Restricción del plano con fotogramas inicial y final: se pueden especificar por separado las imágenes de fotograma inicial y final para restringir el punto de partida y el de llegada del plano, ideal para piezas que requieren una apertura y un cierre precisos.

Reproducibilidad e interruptor de pista de audio: mediante un seed fijo se reproduce el mismo resultado, y el parámetro audio controla si se genera una pista de audio sincronizada, lo que facilita la generación por lotes y la comparación de versiones.

Casos de uso

Materiales de marca o producto convertidos en anuncios cortos: introduce imágenes del producto y un prompt con los puntos de venta para obtener un clip corto con sonido que mantiene la apariencia del producto, útil para páginas de detalle de comercio electrónico y publicaciones en redes sociales.
Fragmentos narrativos de personajes con referencias multimodales: genera clips coherentes de hasta 30 segundos con imágenes de personajes y referencias de audio, como segmentos de material para historias o miniseries.
Materiales convertidos en vídeos explicativos: sube un documento o un enlace web para generar imágenes explicativas del tema correspondiente, útiles para formación interna y presentaciones de producto.
Completado de planos con inicio y final especificados: proporciona dos imágenes de fotogramas clave, inicial y final, para generar un plano de transición con duración controlable e integrarlo en el flujo de montaje posterior.

Limitaciones y recomendaciones de selección

La facturación se basa en los segundos de salida; cuanto mayores sean la resolución y la duración, mayor será el coste, por lo que las combinaciones de vídeos largos y alta calidad deben presupuestarse de antemano. El resultado de la generación depende claramente del prompt: cuando las descripciones de sujeto, acción, plano y estilo no son claras, el resultado varía bastante. Los materiales de referencia y el modo de fotograma inicial y final no se pueden combinar; cada llamada admite solo un documento o una página web de referencia. Cuando se necesiten clips diarios más cortos y ligeros, puede elegirse la línea estándar de la misma familia; para tareas por lotes con requisitos altos de parámetros fijos y reproducibilidad, se recomienda fijar el seed antes de ampliar la escala.

Novedades

Ver el registro de cambios →

Nuevo modelo Lanzamiento del modelo de generación de video wan3.0-video-prime Nov 3, 2026

Preguntas frecuentes

Ver todas las preguntas →

¿Qué tipo de modelo de video es Wan 3.0 Video?

Se centra en el Prompt y también puede incorporar fotogramas inicial y final o imágenes, videos y audios de referencia; los distintos métodos de control deben combinarse según el contrato de parámetros vigente.
¿Qué especificaciones de salida admite Wan 3.0 Video?

Admite de 2 a 30 segundos; las resoluciones incluyen 480P, 720P y 1080P; las relaciones de aspecto incluyen adaptive, 16:9, 4:3, 1:1, 3:4 y 9:16.
¿Se puede generar voz o usar referencias de audio?

Referencias opcionales de imagen, video, audio, archivos y enlaces; compatible con audio sincronizado
¿Cómo se factura Wan 3.0 Video?

Se factura según la duración de salida y el nivel en tiempo real; las diferencias causadas por la resolución, el modo o las opciones de sonido se rigen por el precio de la página y el registro de la tarea.

Crear una tarea de generación

POST https://api.hiapi.ai/v1/tasks

Encabezados

AuthorizationstringObligatorio

Clave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API

Content-TypestringOpcional

El cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.

Idempotency-KeystringOpcional

Clave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.

Clave de idempotencia

Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.

Cuerpo

modelstringObligatorio

Valor fijo actual: wan3.0-video-prime

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para wan3.0-video-prime y la ruta default; consulta la tabla de parámetros a continuación.

seedintegerOpcionalmin 0max 2147483647

Semilla aleatoria; introduzca un valor fijo cuando necesite resultados reproducibles; si no se introduce, el servidor la genera aleatoriamente.

audiobooleanOpcionalPredeterminado: true

Indica si el vídeo de salida incluye una pista de audio sincronizada; valor booleano, por defecto true.

promptstringObligatoriominLength 1maxLength 20000

Indicación que describe la escena, el movimiento, la cámara, la iluminación y el sonido; en el modo de referencia, haga referencia a los materiales correspondientes como Image1, Audio1, etc., en el orden del array.

durationintegerOpcionalPredeterminado: 5min 2max 30

Duración del vídeo de salida, en segundos; rango de 2 a 30, por defecto 5.

resolutionstringOpcionalPredeterminado: "1080P"

Resolución del vídeo de salida, por defecto 1080P.

Opciones:480P720P1080P

aspect_ratiostringOpcionalPredeterminado: "adaptive"

Relación de aspecto de la imagen de salida, por defecto adaptive, es decir, adaptativa a los medios de entrada y a la indicación.

Opciones:adaptive16:94:31:13:49:16

last_frame_urlstringOpcional

URL de una imagen de acceso público que se usa como fotograma final del vídeo; debe usarse junto con first_frame_url.

first_frame_urlstringOpcional

URL de una imagen de acceso público que se usa como fotograma inicial del vídeo; no puede usarse junto con el array de materiales de referencia.

reference_file_urlsarrayOpcionalmaxItems 1

Array de URL de documentos de referencia o presentaciones, máximo 1, y debe ser de acceso público.

Array [ string ]

reference_link_urlsarrayOpcionalmaxItems 1

Array de URL de páginas web de referencia, máximo 1, y la página web debe ser de acceso público sin necesidad de iniciar sesión.

Array [ string ]

reference_audio_urlsarrayOpcionalmaxItems 5

Array de URL de audio de referencia, máximo 5 fragmentos WAV o MP3, cada uno de 1 a 15 segundos, y debe usarse junto con imágenes o vídeos.

Array [ string ]

reference_image_urlsarrayOpcionalmaxItems 10

Array de URL de imágenes de referencia, máximo 10, para la generación de referencias generales.

Array [ string ]

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.

urlstringObligatorio

Obligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.

whenstringOpcionalPredeterminado: "final"

Actualmente solo se admite final: notifica tanto en success como en fail.

Opciones:final

storagestringOpcionalPredeterminado: "temp"

Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.

Opciones:temppersistent

Ejemplos de solicitud

# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan3.0-video-prime",
  "input": {
    "audio": true,
    "prompt": "…",
    "duration": 5,
    "resolution": "1080P",
    "aspect_ratio": "adaptive"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "wan3.0-video-prime",
    input: {
      "audio": true,
      "prompt": "…",
      "duration": 5,
      "resolution": "1080P",
      "aspect_ratio": "adaptive"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "wan3.0-video-prime",
        "input": {
          "audio": True,
          "prompt": "…",
          "duration": 5,
          "resolution": "1080P",
          "aspect_ratio": "adaptive"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtener el detalle de la tarea

GET https://api.hiapi.ai/v1/tasks/:id

Campos de respuesta

taskIdstringObligatorio

ID de tarea, siempre con prefijo tk-hiapi-.

modelstringObligatorio

Nombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.

routestringOpcional

Solo aparece si se usó el parámetro route explícito; repite el valor enviado.

statusstringObligatorio

Estado de la tarea.

Valores de estado

queued En cola, sin iniciar. handling Procesando. archiving Proceso terminado, preparando artefactos. success Terminal: completado, artefactos disponibles (se devuelve output). fail Terminal: error (se devuelve error). Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.

creatednumberObligatorio

Hora de creación de la tarea (segundos Unix).

completednumberObligatorio

Segundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.

outputarrayOpcional

Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).

Array [ object ]

Elementos del array

urlstringObligatorio

URL del artefacto, descargable directamente.

typestringObligatorio

Valores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.

expireAtnumberObligatorio

Segundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.

errorobjectOpcional

Solo con status == fail.

codestringObligatorio

Código de error de negocio.

messagestringObligatorio

Descripción del error.

Ejemplos de respuesta

Éxito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En proceso (no terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fallido

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}