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

# Gebruik Runway in Hermes Agent.

Runway Gen-4 genereert video's van 5 of 10 seconden op 720p of 1080p vanuit een tekstprompt of een eerste-frame-afbeelding. Hermes Agent roept het aan via het RunAPI aangepaste endpoint — configureer custom:runapi eenmaal, stuur text_to_video met een duur en resolutie, en poll voor de voltooide video. Verleng clips met extend_video, of gebruik Runway Aleph voor video-naar-video-bewerking.

## 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. **Configureer RunAPI** — Stel RUNAPI_API_KEY in als omgevingsvariabele waar Hermes Agent draait. Als je RunAPI al als custom:runapi-provider hebt toegevoegd, verwerkt dezelfde sleutel Runway-videoverzoeken — geen extra providerconfiguratie nodig.
2. **Roep Runway text_to_video aan** — Stuur een POST naar het text_to_video-endpoint met model ingesteld op runway, een prompt, duration_seconds (5 of 10) en output_resolution (720p of 1080p). Hermes Agent kan dit verzoek opbouwen via de custom:runapi-provider. Voeg first_frame_image_url toe om het openingsframe te verankeren.
3. **Haal het resultaat op** — Het endpoint retourneert onmiddellijk een task_id. Poll het taakstatusendpoint totdat de status voltooid is, lees dan de uitvoervideo-URL uit de reactie. Om de clip te verlengen, roep extend_video aan met de source_task_id.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Verplicht. Gebruik runway voor Gen-4, of runway-aleph voor Aleph edit_video. |
| `prompt` | `string` | Verplicht. Tekstbeschrijving van de video-inhoud — camerabeweging, scène, belichting. |
| `duration_seconds` | `integer` | Verplicht. Videolengte: 5 of 10 seconden. |
| `output_resolution` | `string` | Verplicht. Uitvoerresolutie: 720p of 1080p. Beïnvloedt de prijs. |
| `first_frame_image_url` | `string` | Optioneel. URL van een afbeelding als eerste frame van de video. |
| `aspect_ratio` | `string` | Optioneel. Uitvoerbeeldverhouding: 16:9, 9:16, 1:1, 4:3 of 3:4. |
| `callback_url` | `string` | Optioneel. Webhook-URL die een POST ontvangt wanneer de taak voltooid is. |

## FAQ

### Kan ik Runway-videogeneratie gebruiken in Hermes Agent?

Ja. Hermes Agent kan het RunAPI Runway-endpoint aanroepen via de custom:runapi-provider. Stel RUNAPI_API_KEY in als omgevingsvariabele en stuur een POST naar /api/v1/runway/text_to_video met model ingesteld op runway, een prompt, duur en resolutie.

### Wat is het verschil tussen Runway Gen-4 en Runway Aleph?

Runway Gen-4 (model: runway) verwerkt text_to_video en extend_video — het genereren van nieuwe clips uit tekst of afbeeldingen. Runway Aleph (model: runway-aleph) verwerkt edit_video — het restylen van bestaand beeldmateriaal met een tekstprompt en source_video_url. Beide werken met dezelfde RunAPI-sleutel.

### Hoe werkt Runway-facturering op RunAPI?

Runway gebruikt matrixfacturering op basis van duration_seconds en output_resolution. Een clip van 5 seconden op 720p kost minder dan een clip van 10 seconden op 1080p. Controleer de RunAPI-prijspagina voor actuele tarieven. Facturering per seconde, geen abonnement vereist.

### Kan ik first_frame_image_url gebruiken voor image-to-video-generatie?

Ja. Stel first_frame_image_url in op een referentieafbeeldings-URL naast je tekstprompt. Runway Gen-4 gebruikt die afbeelding als openingsframe en animeert daaruit volgens je prompt. Dit geeft je nauwkeurige controle over de begincompositie.

### Is Runway-generatie synchroon of asynchroon?

Asynchroon. Het create-endpoint retourneert onmiddellijk een task_id. Videogeneratie duurt doorgaans 30–120 seconden afhankelijk van duur en resolutie. Poll het taakstatusendpoint of geef een callback_url mee om een webhook te ontvangen wanneer de video gereed is.


## Links

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