---
title: "Usa Hailuo en Hermes Agent con RunAPI — Guía de API de generación de video"
url: "https://runapi.ai/pt-BR/hermes-hailuo.md"
canonical: "https://runapi.ai/pt-BR/hermes-hailuo"
locale: "pt-BR"
model: "hailuo"
---

# Usa Hailuo en Hermes Agent.

Hailuo 02 de MiniMax genera video cinematográfico en calidades Pro y Standard. Hermes Agent lo llama a través del proveedor custom:runapi — la misma clave y URL base configuradas para chat. Admite texto a video e imagen a video con duración de 6 o 10 segundos. Las tareas son asíncronas — consulta el task_id hasta que el video esté listo.

## API example

```bash
curl -X POST https://runapi.ai/v1/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hailuo-02-text-to-video-pro",
    "prompt": "A lone lighthouse beam sweeping across a stormy sea at dusk, cinematic wide shot",
    "duration": 6
  }'

```

### 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 añadiste RunAPI como proveedor custom:runapi en Hermes Agent para chat, la misma clave y base_url gestionan también las solicitudes de video de Hailuo.
2. **Llama a Hailuo** — Envía un POST al endpoint text_to_video con model hailuo-02-text-to-video-pro. Incluye un prompt descriptivo y opcionalmente establece duration en 6 o 10. Para animación a partir de imagen, usa el endpoint image_to_video con una image_url.
3. **Obtén el resultado** — El endpoint devuelve un task_id con estado pendiente. Consulta el endpoint de estado de la tarea hasta que el estado cambie a completado y luego recupera la URL del video generado de la respuesta.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obligatorio. hailuo-02-text-to-video-pro, hailuo-02-text-to-video-standard, hailuo-02-image-to-video-pro o hailuo-02-image-to-video-standard. |
| `prompt` | `string` | Descripción de texto del video a generar. |
| `duration` | `integer` | Opcional. Duración del video en segundos — 6 o 10. |
| `image_url` | `string` | Obligatorio para image_to_video. URL de la imagen de entrada a animar. |
| `callback_url` | `string` | Opcional. URL de webhook para notificación de finalización asíncrona. |

## FAQ

### ¿Puedo generar video con Hailuo desde Hermes Agent?

Sí. Llama al endpoint text_to_video con model hailuo-02-text-to-video-pro o hailuo-02-text-to-video-standard. Para video a partir de imagen, usa hailuo-02-image-to-video-pro con una image_url. El proveedor custom:runapi gestiona la autenticación — la misma clave API que para chat.

### ¿Cuál es la diferencia entre Hailuo Pro y Standard?

Pro produce mayor calidad visual y mejor coherencia de movimiento a mayor coste. Standard es más rápido y económico, adecuado para prototipos o iteración de prompts. Ambos admiten duraciones de 6 y 10 segundos.

### ¿Cómo se factura Hailuo en RunAPI?

Hailuo se factura por segundo de video generado. Pro cuesta más por segundo que Standard. La duración es 6 o 10 segundos según el parámetro duration. Consulta la página de precios de RunAPI para las tarifas actuales.

### ¿Hailuo admite generación de video de imagen a video?

Sí. Usa el endpoint image_to_video con hailuo-02-image-to-video-pro o hailuo-02-image-to-video-standard. Pasa una image_url junto con el prompt. El modelo anima la imagen de entrada según el prompt de texto.

### ¿Cómo funciona el polling de tareas para Hailuo en Hermes Agent?

La API devuelve inmediatamente un task_id. Consulta el endpoint de estado de la tarea en intervalos regulares hasta que el campo status cambie a completado. Luego recupera la URL del video de la salida de la respuesta.


## Links

- [Guía de configuración de Hermes Agent →](https://runapi.ai/pt-BR/hermes-agent)
- [Modelos de Hailuo →](https://runapi.ai/pt-BR/models/hailuo)
- [Model catalog](https://runapi.ai/pt-BR/models)
- [API docs](https://runapi.ai/pt-BR/docs)