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.
Einen Kino-Videoclip mit nativem Audio über Google Veo 3 via RunAPI generieren.
Requirements:
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Use the custom:runapi provider with base_url https://runapi.ai/v1.
- Send a POST request to https://runapi.ai/api/v1/veo_3_1/text_to_video
- Set model to "veo-3.1".
- Write a descriptive prompt including scene, camera movement, and audio cues.
- Set duration_seconds to 4, 6, or 8.
- Set aspect_ratio to "16:9", "9:16", or "auto".
- The task is async. Poll the returned task_id until status is "completed".
- When done, read the video URL from the response output.
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"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "veo-3.1"
}
Veo 3 in Hermes Agent in drei Schritten verwenden
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.
export RUNAPI_API_KEY=runapi_xxx
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.
POST /api/v1/veo_3_1/text_to_video
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.
GET /api/v1/veo_3_1/text_to_video/tsk_abc123
Veo 3 text_to_video-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
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. |
Was ist Veo 3 mit Hermes Agent?
Veo 3 von Google DeepMind erstellt Video, das lebendig wirkt – kinematische Visuals mit synchronisiertem Dialog, Ambient-Sound und Musik, alles in einem Durchgang generiert. Über den Hermes-Agent-custom:runapi-Provider erhält man 1080p-Clips bis zu 8 Sekunden mit nativem Audio, sodass kein separater TTS- oder Soundbearbeitungsschritt erforderlich ist.
Veo 3 Anwendungsfälle
Anime- und stilisierte Sequenzen
Anime- oder stilisierte Videoclips mit passenden Audio-Cues generieren. Den visuellen Stil und die Soundrichtung im Prompt beschreiben und Veo 3 rendert beides zusammen.
Musik- und Gesangs-Content
Kurze Musikvideo-Clips oder Gesangsduett-Szenen erstellen. Songtexte oder musikalische Anweisungen im Prompt für synchronisierte Audio-Visuelle Ausgabe einfügen.
Social-Media-Content mit Sound
Bereit-zum-Posten-Videoclips mit eingebautem Ambient-Audio, Voiceover oder Dialog produzieren. Keine Audio-Bearbeitung nötig – die Ausgabe ist mit Video- und Soundtracks vollständig.
Veo 3 + Hermes Agent — Fragen
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.
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.
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.
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.
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.
Hermes Agent Grundeinrichtung
Noch nicht eingerichtet? Mit der RunAPI-Einrichtungsanleitung für Hermes Agent starten.
Hermes Agent Einrichtungsanleitung →Veo 3 in Hermes Agent noch heute ausprobieren.
Einen kostenlosen RunAPI-Key holen, den custom:runapi-Provider konfigurieren und Kino-Videos mit nativem Audio über Google Veo 3 generieren.