Alibaba

Wan 2.7 Video

wan2.7-video/text-to-video

Modelos de generación de video de la serie WAN de Alibaba, compatibles con video a partir de texto, a partir de imagen y con guía por referencia; las entradas de múltiples referencias mantienen la coherencia de personajes y productos entre tomas

wan2.7-video/image-to-video wan2.7-video/text-to-video

Probar wan2.7-video/text-to-video

Entrada

Creaciones

Ver todas las creaciones

Salida

video

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

Precios

wan2.7-video/text-to-video per second

Especificaciones	Precio unitario
720P	$0.100
1080P	$0.167

Descripción general

wan2.7-video/text-to-video es un modelo de texto a video de la serie de video WAN de Alibaba, al que se accede mediante la interfaz unificada de HiAPI.ai. Basta con introducir un prompt de texto para generar un clip de video con imágenes y una pista de audio opcional; admite cinco relaciones de aspecto (16:9, 9:16, 1:1, 4:3 y 3:4), una duración ajustable de 2 a 15 segundos, resolución de 720P o 1080P, además de prompts negativos, semillas aleatorias y reescritura de prompts. Está pensado para desarrolladores que necesitan generar material de video corto a partir de texto, para la producción de contenido en lote y la previsualización de guiones gráficos creativos.

Aspectos destacados

Control programable de los parámetros de texto a video: la duración, la relación de aspecto, la resolución y la semilla se pasan como parámetros de la interfaz, lo que facilita la generación en lote mediante scripts y la reproducibilidad de los resultados.
Pista de audio opcional y reescritura de prompts: se puede pasar una URL de audio wav/mp3 como pista de audio, y la reescritura de prompts está activada de forma predeterminada para completar los detalles de la imagen.
Restricción de la imagen mediante prompts negativos: admite prompts negativos de hasta 500 caracteres para excluir elementos no deseados y reducir la tasa de resultados no válidos.

Descripción de las capacidades

Generación de clips de video según parámetros: genera videos a partir de un prompt junto con la duración (2–15 segundos), la relación de aspecto y el nivel de resolución; las especificaciones de salida se determinan en la solicitud, lo que reduce el recorte y la transcodificación posteriores.

Reescritura de prompts y restricciones negativas: prompt_extend está activado de forma predeterminada y permite ampliar descripciones breves; negative_prompt se pasa de forma independiente para excluir contenido específico de la imagen; ambos se combinan para mejorar el control de los resultados.

Reproducibilidad mediante semilla y estabilidad de los resultados: el parámetro seed permite reproducir o ajustar ligeramente los resultados generados con el mismo prompt, lo que facilita la comparación de los efectos de distintas combinaciones de parámetros.

Audio adjunto y marca de agua opcional: se puede pasar una URL de audio opcional como entrada de la pista de audio generada; el interruptor watermark controla si se añade la marca de agua de generación por IA, de modo que se elige la forma del producto final según sea necesario.

Casos de uso

Equipos de contenido que producen material de video corto en lote: generan clips de 2–15 segundos con prompts mediante scripts, produciendo material de video corto vertical u horizontal listo para publicar o para una edición posterior.
Guiones gráficos creativos y previsualización: con el mismo prompt y distintas semillas se generan rápidamente varias versiones de la imagen, produciendo material de previsualización dinámica para comparar propuestas y confirmar el diseño de planos.
Videos cortos para redes sociales con música: el prompt junto con una URL de audio genera un video final con pista de audio, produciendo contenido corto listo para publicar en plataformas sociales.

Limitaciones y recomendaciones de selección

La duración máxima de una sola generación es de 15 segundos; los videos largos deben generarse por segmentos y unirse después, y la coherencia narrativa depende del procesamiento posterior. Actualmente solo admite texto a video; si se necesita restringir la coherencia de la imagen con imágenes o material de referencia, debe utilizarse la línea de imagen a video de la misma serie. La resolución máxima es 1080P; en escenarios que requieran videos finales de alta resolución, debe evaluarse una solución de ampliación posterior. El prompt admite hasta 5000 caracteres y el prompt negativo hasta 500 caracteres; los guiones demasiado largos deben dividirse en varias solicitudes.

Preguntas frecuentes

Ver todas las preguntas →

¿Wan 2.7 Image to Video requiere subir una imagen?

Sí. Actualmente wan2.7-video/image-to-video es una ruta de video a partir de imagen; la imagen de entrada define el sujeto y la composición inicial, mientras que el Prompt define la acción, el movimiento de cámara y los cambios del entorno.
¿Qué duraciones y resoluciones admite Wan 2.7 Image to Video?

El contrato de solicitud actual de HiAPI admite 2–15s, con resoluciones de salida de 720P y 1080P. Los valores disponibles se rigen por el panel de parámetros de la página y la documentación de la API.
¿Cómo se factura Wan 2.7 Image to Video?

Las tareas se facturan según la duración de salida y el nivel seleccionado. La página muestra el precio en tiempo real con la unidad monetaria global, y el cargo final se basa en el registro de la tarea completada correctamente.
¿Cómo mejorar la estabilidad del sujeto en la generación de video a partir de imágenes?

Utilice una imagen de entrada con el sujeto claro, pocas oclusiones y una composición completa; en el Prompt, describa primero la acción principal y el movimiento de cámara, y luego enumere la apariencia, los materiales y la relación con el fondo que deben conservarse. Para la primera prueba se recomienda usar una duración más corta.

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: wan2.7-video/text-to-video

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para wan2.7-video/text-to-video y la ruta default; consulta la tabla de parámetros a continuación.

seedintegerOpcionalmin 0max 2147483647

Semilla aleatoria para reproducir o ajustar el resultado de la generación; se introduce un número entero, si no se pasa, el sistema la genera aleatoriamente.

ratiostringOpcionalPredeterminado: "16:9"

Relación de aspecto del video, en forma de cadena de proporción; por defecto 16:9.

Opciones:16:99:161:14:33:4

promptstringObligatoriomaxLength 5000

Prompt de texto para la generación del video, utilizado para describir el contenido visual deseado.

durationintegerOpcionalPredeterminado: 5min 2max 15

Duración del video, en segundos; se introduce un número entero, por defecto 5.

audio_urlstringOpcional

URL de audio opcional, compatible con formatos wav/mp3, la duración debe ser de 2 a 30 segundos y el tamaño del archivo no debe superar los 15MB.

watermarkbooleanOpcionalPredeterminado: false

Indica si se añade una marca de agua de generación por IA al video generado; se introduce un valor booleano, por defecto false.

resolutionstringOpcionalPredeterminado: "1080P"

Nivel de resolución del video, cuyo valor afecta al precio de facturación por segundo; por defecto 1080P.

Opciones:720P1080P

prompt_extendbooleanOpcionalPredeterminado: true

Indica si se habilita la función de reescritura (expansión) del prompt; se introduce un valor booleano, por defecto true.

negative_promptstringOpcionalPredeterminado: ""maxLength 500

Prompt negativo, utilizado para excluir contenido visual no deseado, máximo 500 caracteres; por defecto cadena vacía.

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": "wan2.7-video/text-to-video",
  "input": {
    "ratio": "16:9",
    "prompt": "…",
    "duration": 5,
    "watermark": false,
    "resolution": "1080P",
    "prompt_extend": true,
    "negative_prompt": ""
  }
}'

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: "wan2.7-video/text-to-video",
    input: {
      "ratio": "16:9",
      "prompt": "…",
      "duration": 5,
      "watermark": false,
      "resolution": "1080P",
      "prompt_extend": true,
      "negative_prompt": ""
    }
  }),
});
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": "wan2.7-video/text-to-video",
        "input": {
          "ratio": "16:9",
          "prompt": "…",
          "duration": 5,
          "watermark": False,
          "resolution": "1080P",
          "prompt_extend": True,
          "negative_prompt": ""
        }
    },
)
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"
    }
  }
}