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

# Gebruik Veo 3 in Hermes Agent.

Veo 3 is het videogeneratiemodel van Google DeepMind dat 1080p-clips tot 8 seconden produceert met native audio — gesynchroniseerde dialoog, omgevingsgeluid en muziek die naast de video worden gegenereerd. Hermes Agent roept het aan via het RunAPI aangepaste provider-endpoint, met hergebruik van dezelfde API-sleutel die voor chat is geconfigureerd.

## 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. **Configureer RunAPI** — Stel RUNAPI_API_KEY in als omgevingsvariabele waar Hermes Agent draait. Als je RunAPI al als custom:runapi-provider hebt toegevoegd voor chat, verwerken dezelfde sleutel en base_url videogeneratie — geen aparte Google Cloud-credentials nodig.
2. **Roep Veo 3 text_to_video aan** — Stuur een POST naar het text_to_video-endpoint met model ingesteld op veo-3.1. Voeg een prompt toe met scènebeschrijvingen en audiocues (dialoog, omgevingsgeluiden). Stel duration_seconds in op 4, 6 of 8 en aspect_ratio op 16:9 of 9:16. Hermes Agent routeert via de custom:runapi-provider.
3. **Haal het resultaat op** — Het endpoint retourneert onmiddellijk een task_id. Poll het taakstatusendpoint totdat de status verandert naar voltooid, haal dan de uitvoervideo-URL op. De video bevat gesynchroniseerde audio gegenereerd op basis van je prompt.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Verplicht. veo-3.1 (standaardkwaliteit) of veo-3.1-fast (lagere kosten, snellere generatie). |
| `prompt` | `string` | Verplicht. Scènebeschrijving inclusief visuele actie, camerabeweging en audiocues voor dialoog of omgevingsgeluid. |
| `duration_seconds` | `integer` | Optioneel. Videolengte in seconden. Geaccepteerde waarden: 4, 6, 8. Standaard 8. |
| `aspect_ratio` | `string` | Optioneel. Uitvoerbeeldverhouding. Geaccepteerde waarden: 16:9, 9:16, auto. |
| `input_mode` | `string` | Optioneel. Generatiemodus. text (standaard), first_and_last_frames (keyframegestuurd) of reference (stijlreferentie). |
| `first_frame_image_url` | `string` | Optioneel. URL van de eerste-frame-afbeelding. Gebruikt wanneer input_mode first_and_last_frames is. |
| `last_frame_image_url` | `string` | Optioneel. URL van de laatste-frame-afbeelding. Gebruikt wanneer input_mode first_and_last_frames is. |
| `reference_image_urls` | `array` | Optioneel. URL's van stijlreferentieafbeeldingen. Gebruikt wanneer input_mode reference is. |
| `callback_url` | `string` | Optioneel. Webhook-URL die een POST ontvangt wanneer de taak voltooid is. |

## FAQ

### Kan ik Veo 3 gebruiken in Hermes Agent?

Ja. Hermes Agent roept het RunAPI Veo 3 text_to_video-endpoint aan via de custom:runapi-provider. Stel het model in op veo-3.1 en stuur het verzoek met dezelfde RUNAPI_API_KEY die je voor chat gebruikt. Geen Google Cloud-account of aparte video-API-credentials vereist.

### Hoe verwerkt de custom:runapi-provider asynchrone videotaken?

RunAPI retourneert onmiddellijk een task_id bij het eerste POST-verzoek. Je Hermes Agent-workflow pollt het taakstatusendpoint totdat de status voltooid is, en leest vervolgens de uitvoervideo-URL. Je kunt ook callback_url instellen om een webhook te ontvangen in plaats van te pollen.

### Wat is het verschil tussen veo-3.1 en veo-3.1-fast?

Beide produceren video met native audio tot 1080p. veo-3.1 gebruikt de volledige kwaliteitspijplijn en kost meer per generatie. veo-3.1-fast wisselt wat visuele getrouwheid in voor lagere kosten en snellere doorlooptijd — geschikt voor concepten en iteratie.

### Kan ik camerabeweging en audio sturen in Veo 3?

Ja. Beschrijf camerabeweging in de prompt (dolly in, tracking shot, luchtfoto) en Veo 3 interpreteert dit met fysicabewuste simulatie. Voor audio, neem dialoog op tussen aanhalingstekens en beschrijf omgevingsgeluiden — het model genereert gesynchroniseerde audio native, geen apart TTS of geluidsbibliotheek nodig.

### Kan ik een Veo 3-video verlengen of opschalen na generatie?

Ja. RunAPI biedt extend_video- en upscale_video-endpoints voor Veo 3. Geef de source_task_id van de originele generatie mee om de clip te verlengen, of schaal op naar 1080p of 4K resolutie. Beide zijn asynchroon en worden apart gefactureerd.


## Links

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