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

# Veo 3 in Hermes Agent verwenden.

Veo 3 ist Googles DeepMind-Videogenerierungsmodell, das 1080p-Clips von bis zu 8 Sekunden mit nativem Audio produziert — synchronisierter Dialog, Umgebungssound und Musik werden gemeinsam mit dem Video generiert. Hermes Agent ruft es über den RunAPI-Custom-Provider-Endpunkt auf und nutzt denselben API-Key wie für Chat.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/veo_3_1/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1",
    "prompt": "A woman walks through a bustling Tokyo street at night, neon signs reflecting on wet pavement. She speaks into her phone: I just arrived. Ambient city noise, distant car horns, light rain.",
    "duration_seconds": 8,
    "aspect_ratio": "16:9"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "veo-3.1"
}

```

## 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 für Chat hinzugefügt wurde, übernehmen derselbe Key und dieselbe base_url die Videogenerierung — keine separaten Google-Cloud-Zugangsdaten nötig.
2. **Veo 3 text_to_video aufrufen** — Einen POST-Request an den text_to_video-Endpunkt mit model veo-3.1 senden. Einen Prompt mit Szenenbeschreibungen und Audio-Hinweisen (Dialog, Umgebungsgeräusche) einschließen. duration_seconds auf 4, 6 oder 8 und aspect_ratio auf 16:9 oder 9:16 setzen. Hermes Agent leitet durch den custom:runapi-Provider weiter.
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. Das Video enthält synchronisierten Audio, der aus dem Prompt generiert wurde.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Erforderlich. veo-3.1 (Standardqualität) oder veo-3.1-fast (niedrigere Kosten, schnellere Generierung). |
| `prompt` | `string` | Erforderlich. Szenenbeschreibung mit visueller Aktion, Kamerabewegung und Audio-Hinweisen für Dialog oder Umgebungsgeräusche. |
| `duration_seconds` | `integer` | Optional. Videolänge in Sekunden. Akzeptierte Werte: 4, 6, 8. Standard ist 8. |
| `aspect_ratio` | `string` | Optional. Ausgabe-Seitenverhältnis. Akzeptierte Werte: 16:9, 9:16, auto. |
| `input_mode` | `string` | Optional. Generierungsmodus. text (Standard), first_and_last_frames (Keyframe-gesteuert) oder reference (Stil-Referenz). |
| `first_frame_image_url` | `string` | Optional. URL des ersten Frame-Bildes. Wird verwendet, wenn input_mode first_and_last_frames ist. |
| `last_frame_image_url` | `string` | Optional. URL des letzten Frame-Bildes. Wird verwendet, wenn input_mode first_and_last_frames ist. |
| `reference_image_urls` | `array` | Optional. URLs von Stil-Referenzbildern. Wird verwendet, wenn input_mode reference ist. |
| `callback_url` | `string` | Optional. Webhook-URL, die einen POST erhält, wenn der Task abgeschlossen ist. |

## FAQ

### Kann ich Veo 3 in Hermes Agent verwenden?

Ja. Hermes Agent ruft den RunAPI Veo 3 text_to_video-Endpunkt über den custom:runapi-Provider auf. model auf veo-3.1 setzen und den Request mit demselben RUNAPI_API_KEY wie für Chat senden. Kein Google-Cloud-Konto oder separate Video-API-Zugangsdaten erforderlich.

### Wie handhabt der custom:runapi-Provider asynchrone Video-Tasks?

RunAPI gibt sofort eine task_id beim initialen POST zurück. Der Hermes Agent-Workflow fragt den Task-Status-Endpunkt ab, bis der Status completed ist, und liest dann die Video-URL aus der Ausgabe. Man kann auch callback_url setzen, um statt Polling einen Webhook zu erhalten.

### Was ist der Unterschied zwischen veo-3.1 und veo-3.1-fast?

Beide produzieren Videos mit nativem Audio mit bis zu 1080p. veo-3.1 verwendet die vollständige Qualitäts-Pipeline und kostet mehr pro Generierung. veo-3.1-fast tauscht etwas visuelle Qualität gegen niedrigere Kosten und schnellere Fertigstellung — geeignet für Entwürfe und Iterationen.

### Kann ich Kamerabewegung und Audio in Veo 3 steuern?

Ja. Kamerabewegung im Prompt beschreiben (Dolly In, Tracking-Shot, Luftschwenk) und Veo 3 interpretiert es mit physiksbasierter Simulation. Für Audio Dialog in Anführungszeichen einschließen und Umgebungsgeräusche beschreiben — das Modell generiert synchronisierten Audio nativ, ohne separaten TTS oder Sound-Bibliothek.

### Kann ich ein Veo 3-Video nach der Generierung verlängern oder hochskalieren?

Ja. RunAPI stellt extend_video- und upscale_video-Endpunkte für Veo 3 bereit. Die source_task_id aus der ursprünglichen Generierung übergeben, um den Clip zu verlängern, oder auf 1080p oder 4K hochzuskalieren. Beide sind asynchron und werden separat abgerechnet.


## Links

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