---
title: "Usa Hailuo en OpenClaw con RunAPI — Guía de API de video"
url: "https://runapi.ai/es/openclaw-hailuo.md"
canonical: "https://runapi.ai/es/openclaw-hailuo"
locale: "es"
model: "hailuo"
---

# Usa Hailuo en OpenClaw.

Hailuo es el modelo de generación de video de MiniMax que produce metraje nativo a 1080p con simulación precisa de físicas en 6 variantes — Hailuo 02 y 2.3, cada uno con endpoints de texto a video e imagen a video en niveles pro y standard. Los agentes de OpenClaw lo llaman a través de RunAPI con la misma clave API usada para chat.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/hailuo/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hailuo-02-text-to-video-pro",
    "prompt": "A glass marble rolls across a wooden desk, catches the edge, and falls in slow motion. Camera follows the marble. Soft window light, shallow depth of field."
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "hailuo-02-text-to-video-pro"
}

```

## How it works

1. **Configura RunAPI** — Establece la variable de entorno RUNAPI_API_KEY. Si ya configuraste RunAPI como proveedor de OpenClaw para chat, la misma clave funciona para generación de video — no se necesita configuración adicional.
2. **Llama a Hailuo text_to_video o image_to_video** — Envía un POST a /api/v1/hailuo/text_to_video con model establecido en hailuo-02-text-to-video-pro y un prompt que describa la escena. Para video a partir de imagen, usa el endpoint image_to_video con first_frame_image_url para conservar el sujeto de origen.
3. **Consulta el resultado** — El endpoint devuelve un task_id inmediatamente. Consulta el endpoint de estado de la tarea hasta que el estado cambie a completado, luego recupera la URL del video generado de la respuesta. El tiempo típico de respuesta es inferior a dos minutos para el nivel pro.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obligatorio. Uno de: hailuo-02-text-to-video-pro, hailuo-02-text-to-video-standard, hailuo-02-image-to-video-pro, hailuo-02-image-to-video-standard, hailuo-2.3-image-to-video-pro, hailuo-2.3-image-to-video-standard. |
| `prompt` | `string` | Obligatorio. Descripción de texto de la escena del video, movimiento de cámara e iluminación. |
| `first_frame_image_url` | `string` | Obligatorio para endpoints image_to_video. URL de la imagen de origen usada como primer fotograma. |
| `last_frame_image_url` | `string` | Opcional. URL de una imagen usada como último fotograma. Disponible solo en Hailuo 02 image_to_video. |
| `duration_seconds` | `integer` | Opcional. Duración del video en segundos. Valores aceptados: 6 o 10. Por defecto 10 en standard, fijo en pro. |
| `output_resolution` | `string` | Opcional. Resolución de salida. 512p o 768p para 02 standard; 768p o 1080p para variantes 2.3. |
| `callback_url` | `string` | Opcional. URL de webhook que recibe un POST cuando la tarea se completa. |

## FAQ

### ¿Cuál es la diferencia entre Hailuo 02 y Hailuo 2.3?

Hailuo 02 admite tanto texto a video como imagen a video con control de primer y último fotograma. Hailuo 2.3 solo permite imagen a video, pero añade mejor movimiento corporal, micro-expresiones y estilos dedicados de anime e ilustración no disponibles en 02.

### ¿Puedo establecer tanto el primer como el último fotograma de un video?

Sí, pero solo en los endpoints image_to_video de Hailuo 02. Pasa first_frame_image_url y last_frame_image_url juntos. Hailuo 2.3 image_to_video solo acepta first_frame_image_url.

### ¿Cómo funciona el precio pro vs standard?

Hailuo 02 Pro text_to_video cuesta 57 centavos por generación independientemente de la duración. Standard usa precios basados en duración — 30 centavos por 6 segundos, 50 centavos por 10 segundos. El precio de image_to_video standard también tiene en cuenta output_resolution.

### ¿Hailuo es asíncrono o síncrono?

Asíncrono. La API devuelve un task_id inmediatamente. Consulta el endpoint de estado de la tarea o establece un callback_url para recibir un webhook cuando el video esté listo. El tiempo típico de generación es de 60-120 segundos.

### ¿A qué resolución genera Hailuo?

Hailuo 02 Pro genera a 1080p nativo. Standard genera a 512p o 768p según el parámetro output_resolution. Las variantes de Hailuo 2.3 admiten 768p o 1080p. No se aplica escalado posterior.


## Links

- [Guía de configuración de OpenClaw →](https://runapi.ai/es/openclaw)
- [Modelos de Hailuo →](https://runapi.ai/es/models/hailuo)
- [Model catalog](https://runapi.ai/es/models)
- [API docs](https://runapi.ai/es/docs)