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

# Runway in Hermes Agent verwenden.

Runway Gen-4 generiert 5-Sekunden- oder 10-Sekunden-Videos bei 720p oder 1080p aus einem Textprompt oder einem ersten Frame-Bild. Hermes Agent ruft es über den RunAPI-Custom-Endpunkt auf — einmal custom:runapi konfigurieren, text_to_video mit Dauer und Auflösung senden und auf das fertige Video warten. Clips mit extend_video verlängern oder Runway Aleph für Video-zu-Video-Bearbeitung verwenden.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/runway/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "runway",
    "prompt": "A drone shot rising over a misty mountain lake at sunrise, cinematic lighting",
    "duration_seconds": 10,
    "output_resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "runway"
}

```

## 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 Runway-Video-Requests — keine zusätzliche Provider-Konfiguration nötig.
2. **Runway text_to_video aufrufen** — Einen POST an den text_to_video-Endpunkt mit model runway, einem Prompt, duration_seconds (5 oder 10) und output_resolution (720p oder 1080p) senden. Hermes Agent kann diesen Request über den custom:runapi-Provider aufbauen. first_frame_image_url hinzufügen, um den Eröffnungsframe zu verankern.
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. Um den Clip zu verlängern, extend_video mit der source_task_id aufrufen.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Erforderlich. runway für Gen-4 oder runway-aleph für Aleph edit_video. |
| `prompt` | `string` | Erforderlich. Textbeschreibung des Videoinhalts — Kamerabewegung, Szene, Beleuchtung. |
| `duration_seconds` | `integer` | Erforderlich. Videolänge: 5 oder 10 Sekunden. |
| `output_resolution` | `string` | Erforderlich. Ausgabeauflösung: 720p oder 1080p. Beeinflusst den Preis. |
| `first_frame_image_url` | `string` | Optional. URL eines Bildes als ersten Frame des Videos. |
| `aspect_ratio` | `string` | Optional. Ausgabe-Seitenverhältnis: 16:9, 9:16, 1:1, 4:3 oder 3:4. |
| `callback_url` | `string` | Optional. Webhook-URL, die einen POST erhält, wenn der Task abgeschlossen ist. |

## FAQ

### Kann ich die Runway-Videogenerierung in Hermes Agent verwenden?

Ja. Hermes Agent kann den RunAPI Runway-Endpunkt über den custom:runapi-Provider aufrufen. RUNAPI_API_KEY in der Umgebung setzen und einen POST an /api/v1/runway/text_to_video mit model runway, einem Prompt, duration und resolution senden.

### Was ist der Unterschied zwischen Runway Gen-4 und Runway Aleph?

Runway Gen-4 (model: runway) übernimmt text_to_video und extend_video — neue Clips aus Text oder Bildern generieren. Runway Aleph (model: runway-aleph) übernimmt edit_video — vorhandenes Filmmaterial mit einem Textprompt und source_video_url umgestalten. Beide laufen über denselben RunAPI-Key.

### Wie funktioniert die Runway-Preisgestaltung auf RunAPI?

Runway verwendet Matrix-Abrechnung basierend auf duration_seconds und output_resolution. Ein 5-Sekunden-720p-Clip kostet weniger als ein 10-Sekunden-1080p-Clip. Aktuelle Preise auf der RunAPI-Preisseite. Sekundenbasierte Abrechnung, kein Abonnement nötig.

### Kann ich first_frame_image_url für Image-to-Video-Generierung verwenden?

Ja. first_frame_image_url auf eine Referenzbild-URL zusammen mit dem Textprompt setzen. Runway Gen-4 verwendet dieses Bild als Eröffnungsframe und animiert ab dort gemäß dem Prompt. Das gibt präzise Kontrolle über die Startkomposition.

### Ist die Runway-Generierung synchron oder asynchron?

Asynchron. Der Create-Endpunkt gibt sofort eine task_id zurück. Die Videogenerierung dauert typischerweise 30–120 Sekunden je nach Dauer und Auflösung. Den Task-Status-Endpunkt abfragen oder callback_url angeben, um einen Webhook zu erhalten, wenn das Video bereit ist.


## Links

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