Alibaba

HappyHorse 1.1

happyhorse-1.1/image-to-video

Modelo de generación de video de Alibaba; un solo modelo cubre texto a video, imagen a video y video a partir de imágenes de referencia, admite 1080p y clips de 3 a 15 segundos, y la fusión de múltiples imágenes de referencia refuerza la consistencia de los personajes; es adecuado para narrativas de múltiples tomas y material publicitario de comercio electrónico

happyhorse-1.1/image-to-video happyhorse-1.1/reference-to-video happyhorse-1.1/text-to-video

Probar happyhorse-1.1/image-to-video

Entrada

Creaciones

Ver todas las creaciones

Salida

video

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

Precios

happyhorse-1.1/image-to-video per second

Especificaciones	Precio unitario
720P	$0.160
1080P	$0.210

Descripción general

happyhorse-1.1/image-to-video es la línea de generación de video basada en el primer fotograma de la familia HappyHorse 1.1 de Alibaba: recibe como entrada una imagen del primer fotograma y un prompt de texto opcional, y produce un video corto de 720p o 1080p, de 3 a 15 segundos. Es adecuada para desarrolladores que ya disponen de material visual utilizable y desean extender una imagen estática en un movimiento coherente, para usos como storyboards de microseries, presentaciones de productos de comercio electrónico y videos cortos para redes sociales, donde se requiere un sujeto estable; se invoca mediante la interfaz unificada de HiAPI.ai y se factura según la duración de salida.

Puntos clave

El primer fotograma fija el punto de partida de la imagen: una imagen JPEG/PNG/WEBP sirve como punto de partida de la generación, de modo que la composición y el sujeto del video de salida se desarrollan a partir de una imagen predeterminada, lo que reduce la aleatoriedad de la generación puramente textual.
Duración y resolución combinables según la necesidad: cada segmento puede durar de 3 a 15 segundos y se ofrecen dos niveles de resolución (720p y 1080p), lo que facilita ajustar las especificaciones de salida a la plataforma de difusión y al presupuesto de costos.
El prompt es opcional, pero aún permite controlar el movimiento: el prompt es un campo opcional de hasta 5000 caracteres que puede describir la dirección del movimiento y el estilo visual; si no se rellena, la generación se controla directamente por el primer fotograma.

Descripción de capacidades

Generación de video a partir de una imagen del primer fotograma: basta con enviar exactamente una imagen del primer fotograma para generar un video; el lado corto de la imagen debe ser de al menos 300 px y su tamaño no debe superar los 20 MB. Resulta adecuada para convertir directamente bocetos de diseño o material de rodaje existentes en clips animados.

Control de duración y resolución: duration admite de 3 a 15 segundos, con 5 segundos por defecto; resolution admite 720p y 1080p, con 1080p por defecto. Los desarrolladores pueden elegir las especificaciones según el uso del clip; el costo varía con la duración y la resolución.

El prompt guía el movimiento y el estilo: el campo opcional prompt admite hasta 5000 caracteres y sirve para describir el tipo de movimiento y el estilo visual deseados, ajustando la orientación de la generación sin cambiar la composición del primer fotograma.

Casos de uso

Equipos de comercio electrónico generan videos de presentación a partir de la imagen del primer fotograma de un producto: usan la imagen principal del producto como primer fotograma, junto con una breve descripción de movimiento, para producir videos dinámicos del producto de varios segundos destinados a la página de detalles y a los materiales de difusión en el feed.
Creadores de contenido animan ilustraciones o storyboards: convierten un único storyboard o ilustración en un clip con movimiento coherente que se incorpora al flujo de edición como material de plano para microseries o videos cortos en redes sociales.
Las marcas añaden versiones dinámicas a sus activos visuales existentes: usan material gráfico ya existente como primer fotograma para generar una versión dinámica, ampliando rápidamente la biblioteca de materiales de marketing y adaptándose a las especificaciones de video corto de distintos canales.

Limitaciones y recomendaciones de selección

La duración máxima por segmento es de 15 segundos; los contenidos más largos requieren generar por segmentos y unirlos después. La resolución máxima es 1080p, por lo que no es adecuada para salidas de nivel cinematográfico en alta resolución. Esta línea solo acepta una única imagen del primer fotograma y no puede mantener la consistencia de personajes mediante múltiples imágenes de referencia; para ese tipo de necesidad conviene elegir la línea reference-to-video de la misma familia. Cuando no se dispone de una imagen existente y es necesario construir el plano desde cero, text-to-video es más apropiado. La facturación se basa en los segundos de salida, por lo que generar múltiples candidatos o clips largos acumula costos; se recomienda validar primero el resultado con duraciones cortas.

Preguntas frecuentes

Ver todas las preguntas →

¿HappyHorse 1.1 Reference to Video requiere subir imágenes?

Sí. Actualmente happyhorse-1.1/reference-to-video es una ruta de generación de video por referencia, que puede usar imágenes de referencia para restringir el sujeto, el estilo y la escena; el Prompt se encarga de los cambios de acción, cámara y entorno.
¿Qué duraciones y resoluciones admite HappyHorse 1.1 Reference to Video?

El contrato de solicitud actual de HiAPI admite de 3 a 15 s, 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 HappyHorse 1.1 Reference to Video?

La tarea se factura según la duración de salida y el nivel seleccionado. La página muestra el precio en tiempo real siguiendo 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?

Utiliza imágenes de entrada con el sujeto claro, pocas oclusiones y una composición completa; en el Prompt, describe primero la acción principal y la toma de cámara, y luego enumera 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: happyhorse-1.1/image-to-video

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para happyhorse-1.1/image-to-video y la ruta default; consulta la tabla de parámetros a continuación.

promptstringOpcionalmaxLength 5000

Texto de indicación opcional para guiar el movimiento y el estilo del video generado; si no se proporciona, se deduce a partir de la imagen del primer fotograma.

durationintegerOpcionalPredeterminado: 5min 3max 15

Duración del fragmento de video generado, en segundos, con un rango de 3 a 15; el costo aumenta con la duración, por defecto 5 segundos.

image_urlsarrayObligatoriominItems 1maxItems 1

Arreglo de URL de imágenes del primer fotograma, debe contener exactamente 1 elemento; admite formatos JPEG/PNG/WEBP, con el lado más corto no menor a 300px y un tamaño por archivo no superior a 20MB.

Array [ string ]

resolutionstringOpcionalPredeterminado: "1080p"

Resolución del video de salida; cuanto mayor sea la resolución, mayor será el costo, por defecto 1080p.

Opciones:720p1080p

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": "happyhorse-1.1/image-to-video",
  "input": {
    "duration": 5,
    "image_urls": "…",
    "resolution": "1080p"
  }
}'

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: "happyhorse-1.1/image-to-video",
    input: {
      "duration": 5,
      "image_urls": "…",
      "resolution": "1080p"
    }
  }),
});
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": "happyhorse-1.1/image-to-video",
        "input": {
          "duration": 5,
          "image_urls": "…",
          "resolution": "1080p"
        }
    },
)
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"
    }
  }
}