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

# Kling in Hermes Agent verwenden.

Kling 3.0 von Kuaishou generiert Videos aus Text oder Bildern mit bis zu 1080p, nativem Audio, Multi-Shot-Szenen und 3–15 Sekunden Dauer. Hermes Agent ruft es über RunAPI mit dem custom:runapi-Provider auf — derselbe Key und dieselbe Base-URL wie für Chat.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/kling/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0",
    "prompt": "A drone shot pulling back from a mountain lake at sunrise, mist rising off the water, cinematic lighting",
    "duration_seconds": 5,
    "aspect_ratio": "16:9",
    "enable_sound": true,
    "output_resolution": "1080p"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "kling-3.0"
}

```

## How it works

1. **RunAPI konfigurieren** — Die RUNAPI_API_KEY-Umgebungsvariable setzen. Wenn RunAPI bereits als custom:runapi-Provider in Hermes Agent für Chat hinzugefügt wurde, funktionieren derselbe Key und dieselbe base_url für die Videogenerierung — keine zusätzliche Konfiguration nötig.
2. **Kling text_to_video aufrufen** — Einen POST-Request an /api/v1/kling/text_to_video mit model kling-3.0 senden. Einen Prompt, duration_seconds (3–15), aspect_ratio und optional enable_sound für nativen Audio angeben. Für bildgesteuerte Generierung /api/v1/kling/image_to_video mit first_frame_image_url verwenden.
3. **Ergebnis abrufen** — Der Endpunkt gibt sofort eine task_id zurück. Den Task-Status-Endpunkt abfragen, bis der Status auf completed wechselt, dann die Video-URL aus der Antwort abrufen. Die Generierung dauert typischerweise 30–120 Sekunden je nach Dauer und Auflösung.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Erforderlich. kling-3.0 für die neueste Version. |
| `prompt` | `string` | Videobeschreibung. Erforderlich, außer multi_shots ist aktiviert. |
| `duration_seconds` | `integer` | Videolänge. Kling 3.0 unterstützt 3–15 Sekunden. Ältere Versionen akzeptieren 5 oder 10. |
| `aspect_ratio` | `string` | Ausgabe-Seitenverhältnis: 16:9, 9:16 oder 1:1. |
| `output_resolution` | `string` | Auflösung: 720p, 1080p oder 4k. Höhere Auflösung kostet mehr pro Sekunde. |
| `enable_sound` | `boolean` | Nativen Audio neben dem Video generieren. Erhöht die Kosten pro Sekunde. |
| `negative_prompt` | `string` | Elemente, die von der Generierung ausgeschlossen werden sollen. |
| `first_frame_image_url` | `string` | Bild-URL als Eröffnungsframe (Einzelaufnahme-Modus). |
| `cfg_scale` | `number` | Guidance-Skala (0–1). Höhere Werte folgen dem Prompt enger. |
| `multi_shots` | `boolean` | Multi-Shot-Szenegenerierung mit separaten Prompts pro Segment aktivieren. |

## FAQ

### Wie funktioniert die sekundenbasierte Abrechnung von Kling auf RunAPI?

Kling berechnet pro Sekunde generiertes Video. Der Preis hängt von output_resolution und enable_sound ab. Ein 5-Sekunden-720p-Clip ohne Sound ist die günstigste Option; 1080p mit Sound kostet ungefähr doppelt so viel pro Sekunde. Aktuelle Preise auf der RunAPI-Preisseite.

### Was ist der Unterschied zwischen text_to_video und image_to_video?

text_to_video generiert einen Clip allein aus einem Textprompt. image_to_video benötigt eine first_frame_image_url und animiert ab diesem Bild. Beide Endpunkte geben eine asynchrone task_id zurück und unterstützen dieselben Dauer- und Auflösungsoptionen.

### Kann ich andere Kling-Versionen außer 3.0 verwenden?

Ja. RunAPI hostet auch kling-v2.5-turbo-text-to-video-pro und kling-v2.5-turbo-image-to-video-pro für schnellere, kostengünstigere Generierung bei 5 oder 10 Sekunden. Den model-Parameter auf den gewünschten Versions-Slug setzen.

### Braucht Hermes Agent einen separaten Provider für Kling-Video?

Nein. Wenn der custom:runapi-Provider bereits in Hermes Agent für Chat oder Bildgenerierung konfiguriert ist, funktionieren dieselbe base_url und derselbe API-Key für Kling-Video-Endpunkte. Einfach den Request-Pfad und den model-Parameter ändern.

### Was passiert, wenn die Kling-Generierung fehlschlägt — werde ich trotzdem berechnet?

Nein. RunAPI berechnet nur abgeschlossene Generierungen. Wenn der Task fehlschlägt oder upstream ein Timeout auftritt, werden die reservierten Credits auf das Kontoguthaben zurückgebucht.


## Links

- [Hermes Agent Einrichtungsanleitung →](https://runapi.ai/de/hermes-agent)
- [Kling Modelle →](https://runapi.ai/de/models/kling)
- [Model catalog](https://runapi.ai/de/models)
- [API docs](https://runapi.ai/de/docs)