---
title: "Usa Luma en OpenClaw con RunAPI — API de modificación de video"
url: "https://runapi.ai/pt-BR/openclaw-luma.md"
canonical: "https://runapi.ai/pt-BR/openclaw-luma"
locale: "pt-BR"
model: "luma"
---

# Usa Luma en OpenClaw.

Luma Ray 3.2 modifica video existente con transformaciones guiadas por prompt que preservan la coherencia espacial y la estructura de escena 3D. Envía una URL de video fuente y un prompt de texto describiendo la transformación — Luma re-renderiza el metraje con iluminación atmosférica, detalle ambiental y movimiento de cámara físicamente consistente. Los agentes de OpenClaw lo llaman a través de la misma clave RunAPI usada para chat.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/luma/modify_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "luma-modify-video",
    "prompt": "Transform the scene into a foggy autumn morning with golden light filtering through trees",
    "source_video_url": "https://example.com/park-walk.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 configuraste RunAPI para chat en OpenClaw, la misma clave funciona para la modificación de video con Luma — sin configuración adicional de proveedor.
2. **Llama a Luma modify_video** — Envía una solicitud POST al endpoint modify_video con model establecido en luma-modify-video, source_video_url apuntando a tu metraje de entrada y un prompt describiendo la transformación. Luma preserva la geometría original de la escena mientras aplica los cambios solicitados.
3. **Consulta el resultado** — El endpoint devuelve un task_id de inmediato. Consulta el endpoint de estado de la tarea hasta que el estado sea completado y luego lee la URL del video de salida de la respuesta. La modificación de video típicamente toma de 30 a 120 segundos dependiendo de la complejidad.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obligatorio. Usa luma-modify-video. |
| `prompt` | `string` | Obligatorio. Descripción textual de la transformación de video deseada — cambios de estilo, iluminación, atmósfera o ediciones de escena. |
| `source_video_url` | `string` | Obligatorio. URL del video fuente a modificar. Debe ser un archivo MP4 o MOV accesible públicamente. |
| `watermark` | `boolean` | Opcional. Si añadir una marca de agua al video de salida. |
| `callback_url` | `string` | Opcional. URL de webhook que recibe un POST cuando la tarea se completa. |

## FAQ

### ¿Qué tipo de transformaciones puede hacer Luma modify_video?

Luma modify_video re-renderiza metraje existente con cambios guiados por prompt — cambios atmosféricos (niebla, lluvia, hora dorada), transferencias de estilo (cinematográfico, anime, noir), rediseño de iluminación y transformaciones ambientales. Preserva el movimiento de cámara original y la disposición espacial de la escena.

### ¿En qué se diferencia Luma de otros modelos de video en RunAPI?

Luma se especializa en modificar video existente en lugar de generar desde cero. Su modelo Ray 3.2 mantiene la coherencia espacial 3D durante las transformaciones, por lo que los objetos conservan sus relaciones de profundidad y el movimiento de cámara permanece físicamente consistente. Modelos como Kling o Hailuo generan video nuevo a partir de texto o imágenes.

### ¿Luma modify_video es síncrono o asíncrono?

Asíncrono. El endpoint de creación devuelve un task_id de inmediato. Consulta el endpoint de estado de la tarea o proporciona un callback_url para recibir un webhook cuando el video modificado esté listo. El tiempo de procesamiento típico es de 30 a 120 segundos.

### ¿Cuánto cuesta la modificación de video con Luma en RunAPI?

Luma usa facturación fija por tarea — cada llamada a modify_video cuesta una cantidad fija independientemente de la duración del video. Consulta la página de precios de RunAPI para las tarifas actuales. Las generaciones fallidas no se cobran.

### ¿Puedo encadenar Luma con otros modelos de video de RunAPI en un flujo de trabajo de agente?

Sí. Un agente de OpenClaw puede generar un video con Kling o Hailuo, y luego pasar la URL de salida como source_video_url a Luma modify_video para post-procesamiento — todo con la misma RUNAPI_API_KEY. Cada paso usa el mismo patrón de polling asíncrono.


## Links

- [Guía de configuración de OpenClaw →](https://runapi.ai/pt-BR/openclaw)
- [Luma en RunAPI →](https://runapi.ai/pt-BR/models/luma)
- [Model catalog](https://runapi.ai/pt-BR/models)
- [API docs](https://runapi.ai/pt-BR/docs)