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

# Usa Runway en Hermes Agent.

Runway genera video creativo con control preciso de cámara — movimientos de cámara cinematográficos, cambios de iluminación dramáticos y estilos visuales variados. 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. Las tareas son asíncronas.

## 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": "runway",
    "prompt": "A time-lapse of storm clouds building over a vast desert, dramatic lighting shifts",
    "duration": 5,
    "ratio": "1280:768"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "runway"
}

```

## 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 Runway.
2. **Llama a Runway** — Envía un POST al endpoint text_to_video con model runway. Incluye un prompt descriptivo — especifica movimientos de cámara (zoom, paneo, inclinación) directamente en el prompt. Opcionalmente establece duration y ratio.
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. runway o runway-aleph. |
| `prompt` | `string` | Descripción de texto del video a generar. Puede incluir movimientos de cámara específicos. |
| `duration` | `integer` | Opcional. Duración del video en segundos — 5 o 10. |
| `ratio` | `string` | Opcional. Ratio de aspecto del video, p. ej. 1280:768 (horizontal) o 768:1280 (vertical). |
| `image_url` | `string` | Obligatorio para image_to_video. URL de la imagen de referencia a animar. |
| `callback_url` | `string` | Opcional. URL de webhook para notificación de finalización asíncrona. |

## FAQ

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

Sí. Llama al endpoint text_to_video con model runway a través del proveedor custom:runapi. La misma RUNAPI_API_KEY que usas para chat gestiona también las solicitudes de video de Runway.

### ¿Qué hace especial a Runway para generación de video?

Runway se especializa en video creativo con control de cámara preciso — movimientos de cámara como zoom, paneo e inclinación se pueden especificar en el prompt. Runway Aleph es la variante premium con mayor coherencia y calidad cinematográfica.

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

Runway se factura por segundo de video generado. La duración puede ser 5 o 10 segundos. Consulta la página de precios de RunAPI para las tarifas actuales por segundo.

### ¿Runway admite animación de imagen a video?

Sí. Usa el endpoint image_to_video con model runway y una image_url de entrada. El modelo anima la imagen de referencia basándose en el prompt de texto.

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

La API devuelve un task_id de inmediato. Consulta el endpoint de estado de la tarea a 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/es/hermes-agent)
- [Runway en RunAPI →](https://runapi.ai/es/models/runway)
- [Model catalog](https://runapi.ai/es/models)
- [API docs](https://runapi.ai/es/docs)