---
title: "Luma in Hermes Agent via RunAPI verwenden — Video-Modifikations-API-Anleitung"
url: "https://runapi.ai/de/hermes-luma.md"
canonical: "https://runapi.ai/de/hermes-luma"
locale: "de"
model: "luma"
---

# Luma in Hermes Agent verwenden.

Luma Ray 3.2 modifiziert vorhandene Videos mit promptgesteuerten Transformationen, die räumliche Kohärenz und 3D-Szenenstruktur bewahren. Eine Quellvideo-URL und einen Textprompt zur Transformation senden — Luma rendert das Filmmaterial mit atmosphärischer Beleuchtung, Umgebungsdetails und physisch konsistenter Kamerabewegung neu. Hermes Agent ruft es über den RunAPI-Custom-Endpunkt auf.

## 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. **RunAPI konfigurieren** — RUNAPI_API_KEY in der Umgebung setzen, in der Hermes Agent läuft. Wenn RunAPI bereits als custom:runapi-Provider hinzugefügt wurde, übernimmt derselbe Key die Luma-Videomodifikations-Requests.
2. **Luma modify_video aufrufen** — Einen POST-Request an den modify_video-Endpunkt mit model luma-modify-video, der source_video_url zum Eingabematerial und einem die Transformation beschreibenden Prompt senden. Hermes Agent kann diesen Request über den custom:runapi-Provider aufbauen und senden.
3. **Ergebnis abrufen** — Der Endpunkt gibt sofort eine task_id zurück. Den Task-Status-Endpunkt abfragen, bis der Status completed ist, dann die Video-URL aus der Antwort auslesen. Die Videomodifikation dauert typischerweise 30–120 Sekunden je nach Komplexität.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Erforderlich. luma-modify-video verwenden. |
| `prompt` | `string` | Erforderlich. Textbeschreibung der gewünschten Videotransformation — Stiländerungen, Beleuchtung, Atmosphäre oder Szenenkorrekturen. |
| `source_video_url` | `string` | Erforderlich. URL des Quellvideos. Muss eine öffentlich zugängliche MP4- oder MOV-Datei sein. |
| `watermark` | `boolean` | Optional. Ob ein Wasserzeichen zum Ausgabevideo hinzugefügt werden soll. |
| `callback_url` | `string` | Optional. Webhook-URL, die einen POST erhält, wenn der Task abgeschlossen ist. |

## FAQ

### Welche Transformationen kann Luma modify_video durchführen?

Luma modify_video rendert vorhandenes Filmmaterial mit promptgesteuerten Änderungen neu — atmosphärische Verschiebungen (Nebel, Regen, goldene Stunde), Stil-Transfers (Kino, Anime, Noir), Beleuchtungsumbauten und Umgebungstransformationen. Es bewahrt die ursprüngliche Kamerabewegung und räumliche Anordnung der Szene.

### Wie konfiguriere ich den custom:runapi-Provider für Luma in Hermes Agent?

Einen Custom-Provider namens runapi in der Hermes Agent-Konfiguration mit base_url https://runapi.ai/v1 und key_env RUNAPI_API_KEY hinzufügen. Nach der Konfiguration übernimmt derselbe Provider Luma modify_video-Aufrufe neben Chat und anderen RunAPI-Modell-Requests.

### Ist Luma modify_video synchron oder asynchron?

Asynchron. Der Create-Endpunkt gibt sofort eine task_id zurück. Den Task-Status-Endpunkt abfragen oder callback_url angeben, um einen Webhook zu erhalten, wenn das modifizierte Video bereit ist. Typische Bearbeitungszeit ist 30–120 Sekunden.

### Was kostet die Luma-Videomodifikation auf RunAPI?

Luma verwendet Pauschalabrechnung pro Task — jeder modify_video-Aufruf kostet einen festen Betrag unabhängig von der Videolänge. Aktuelle Preise auf der RunAPI-Preisseite. Fehlgeschlagene Generierungen werden nicht berechnet.

### Kann Hermes Agent Luma mit Videogenerierungsmodellen in einem Workflow verketten?

Ja. Ein Hermes Agent-Workflow kann ein Video mit Kling oder Wan generieren, dann die Ausgabe-URL als source_video_url an Luma modify_video zur atmosphärischen Neu-Renderung übergeben — alles über denselben custom:runapi-Provider und RUNAPI_API_KEY. Jeder Schritt verwendet dasselbe asynchrone Polling-Muster.


## Links

- [Hermes Agent Einrichtungsanleitung →](https://runapi.ai/de/hermes-agent)
- [Luma on RunAPI →](https://runapi.ai/de/models/luma)
- [Model catalog](https://runapi.ai/de/models)
- [API docs](https://runapi.ai/de/docs)