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

# Usa Luma in Hermes Agent.

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. Hermes Agent lo chiama tramite l'endpoint personalizzato RunAPI.

## 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 nell'ambiente in cui Hermes Agent viene eseguito. Se hai già aggiunto RunAPI come provider custom:runapi, la stessa key e base_url gestiscono le richieste di modifica video con Luma.
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. Hermes Agent può costruire e inviare questa richiesta tramite il provider custom:runapi.
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.

### Come configuro il provider custom:runapi per Luma in Hermes Agent?

Aggiungi un provider personalizzato chiamato runapi nella configurazione di Hermes Agent con base_url https://runapi.ai/v1 e key_env RUNAPI_API_KEY. Una volta configurato, lo stesso provider gestisce le chiamate a Luma modify_video insieme alla chat e ad altre richieste ai modelli RunAPI.

### 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.

### Hermes Agent può concatenare Luma con modelli di generazione video in un unico workflow?

Sì. Un workflow di Hermes Agent può generare un video con Kling o Wan, poi passare l'URL di output come source_video_url a Luma modify_video per il re-rendering atmosferico — tutto tramite lo stesso provider custom:runapi e RUNAPI_API_KEY. Ogni passaggio utilizza lo stesso schema di polling asincrono.


## Links

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