---
title: "Usa Luma in OpenClaw tramite RunAPI — API di Modifica Video"
url: "https://runapi.ai/it/openclaw-luma.md"
canonical: "https://runapi.ai/it/openclaw-luma"
locale: "it"
model: "luma"
---

# Usa Luma in OpenClaw.

Luma Ray 3.2 modifica i video esistenti con trasformazioni guidate da prompt che preservano la coerenza spaziale e la struttura 3D della scena. Invia l'URL di un video sorgente e un prompt testuale che descrive la trasformazione — Luma esegue il re-rendering del filmato con illuminazione atmosferica, dettagli ambientali e movimento della telecamera fisicamente coerente. Gli agenti OpenClaw lo chiamano tramite la stessa API key RunAPI usata per la 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** — Imposta RUNAPI_API_KEY nel tuo ambiente. Se hai già configurato RunAPI per la chat in OpenClaw, la stessa key funziona per la modifica video con Luma — nessuna configurazione aggiuntiva del provider necessaria.
2. **Chiama Luma modify_video** — Invia una richiesta POST all'endpoint modify_video con model impostato su luma-modify-video, il source_video_url che punta al filmato di input e un prompt che descrive la trasformazione. Luma preserva la geometria originale della scena applicando le modifiche richieste.
3. **Ottieni il risultato** — L'endpoint restituisce immediatamente un task_id. Esegui il polling dell'endpoint di stato del task finché lo stato non cambia in completed, poi leggi l'URL del video di output dalla risposta. La modifica video richiede tipicamente 30-120 secondi a seconda della complessità.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obbligatorio. Usa luma-modify-video. |
| `prompt` | `string` | Obbligatorio. Descrizione testuale della trasformazione video desiderata — cambiamenti di stile, illuminazione, atmosfera o modifiche alla scena. |
| `source_video_url` | `string` | Obbligatorio. URL del video sorgente da modificare. Deve essere un file MP4 o MOV accessibile pubblicamente. |
| `watermark` | `boolean` | Facoltativo. Indica se aggiungere una filigrana al video di output. |
| `callback_url` | `string` | Facoltativo. URL webhook che riceve una POST quando il task è completato. |

## FAQ

### Che tipo di trasformazioni può fare Luma modify_video?

Luma modify_video esegue il re-rendering dei video esistenti con modifiche guidate da prompt — cambiamenti atmosferici (nebbia, pioggia, luce dorata), trasferimenti di stile (cinematografico, anime, noir), revisioni dell'illuminazione e trasformazioni ambientali. Preserva il movimento originale della telecamera e la struttura spaziale della scena.

### In cosa si differenzia Luma dagli altri modelli video su RunAPI?

Luma è specializzato nella modifica di video esistenti anziché nella generazione da zero. Il suo modello Ray 3.2 mantiene la coerenza spaziale 3D durante le trasformazioni, in modo che gli oggetti mantengano le loro relazioni di profondità e il movimento della telecamera rimanga fisicamente coerente. Modelli come Kling o Hailuo generano nuovi video da testo o immagini.

### Luma modify_video è sincrono o asincrono?

Asincrono. L'endpoint di creazione restituisce immediatamente un task_id. Esegui il polling dell'endpoint di stato del task o fornisci un callback_url per ricevere un webhook quando il video modificato è pronto. Il tempo di elaborazione tipico è di 30-120 secondi.

### Quanto costa la modifica video con Luma su RunAPI?

Luma utilizza una fatturazione flat per task — ogni chiamata a modify_video costa un importo fisso indipendentemente dalla lunghezza del video. Controlla la pagina dei prezzi di RunAPI per le tariffe aggiornate. Le generazioni fallite non vengono addebitate.

### Posso concatenare Luma con altri modelli video RunAPI in un workflow di agenti?

Sì. Un agente OpenClaw può generare un video con Kling o Hailuo, poi passare l'URL di output come source_video_url a Luma modify_video per la post-elaborazione — tutto tramite la stessa RUNAPI_API_KEY. Ogni passaggio utilizza lo stesso schema di polling asincrono.


## Links

- [Guida di configurazione di OpenClaw →](https://runapi.ai/it/openclaw)
- [Luma su RunAPI →](https://runapi.ai/it/models/luma)
- [Model catalog](https://runapi.ai/it/models)
- [API docs](https://runapi.ai/it/docs)