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

# Usa Luma en Hermes Agent.

Luma ofrece modificación de video guiada por texto con coherencia espacial — transforma el estilo, los colores y la atmósfera de clips existentes. Hermes Agent lo llama a través del proveedor custom:runapi — la misma clave y URL base configuradas para chat. Proporciona una source_video_url y un prompt de transformación. 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": "luma-modify-video",
    "prompt": "Transform the clip into a dreamlike watercolor animation with soft pastel colors",
    "source_video_url": "https://example.com/source.mp4"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "luma-modify-video"
}

```

## 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 funcionan para las solicitudes de Luma.
2. **Llama a Luma** — Envía un POST al endpoint modify_video con model luma-modify-video. Incluye una source_video_url apuntando al video a transformar y un prompt de texto describiendo la transformación. Hermes Agent enruta la solicitud a través del proveedor custom:runapi.
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 transformado de la respuesta.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obligatorio. luma-modify-video. |
| `prompt` | `string` | Descripción de texto de la transformación a aplicar al video. |
| `source_video_url` | `string` | URL del video fuente a transformar. |
| `callback_url` | `string` | Opcional. URL de webhook para notificación de finalización asíncrona. |

## FAQ

### ¿Puedo modificar video con Luma desde Hermes Agent?

Sí. Usa el endpoint modify_video con model luma-modify-video a través del proveedor custom:runapi. Pasa una source_video_url y un prompt de texto que describe la transformación deseada. La misma RUNAPI_API_KEY gestiona la autenticación.

### ¿Qué hace exactamente el endpoint modify_video de Luma?

Luma modify_video toma un video existente y aplica una transformación guiada por texto — cambiar el estilo artístico, la paleta de colores, la iluminación o la atmósfera mientras conserva la coherencia espacial y el movimiento del video original.

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

Luma se factura por tarea en RunAPI. El coste depende de la duración del video de entrada. Consulta la página de precios de RunAPI para las tarifas actuales. Sin suscripción ni gasto mínimo.

### ¿Cuánto tarda Luma en completar una solicitud de modify_video?

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 modificado de la salida de la respuesta.


## Links

- [Guía de configuración de Hermes Agent →](https://runapi.ai/es/hermes-agent)
- [Luma en RunAPI →](https://runapi.ai/es/models/luma)
- [Model catalog](https://runapi.ai/es/models)
- [API docs](https://runapi.ai/es/docs)