---
title: "Utiliser Runway dans Hermes Agent via RunAPI — Guide API Vidéo"
url: "https://runapi.ai/fr/hermes-runway.md"
canonical: "https://runapi.ai/fr/hermes-runway"
locale: "fr"
model: "runway"
---

# Utiliser Runway dans Hermes Agent.

Runway Gen-4 génère des vidéos de 5 ou 10 secondes en 720p ou 1080p à partir d'un prompt textuel ou d'une image de premier plan. Hermes Agent l'appelle via l'endpoint personnalisé RunAPI — configurez custom:runapi une fois, envoyez text_to_video avec une durée et une résolution, et interrogez pour la vidéo terminée. Prolongez les clips avec extend_video, ou utilisez Runway Aleph pour l'édition video-to-video.

## 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. **Configurer RunAPI** — Définissez RUNAPI_API_KEY dans l'environnement où Hermes Agent s'exécute. Si vous avez déjà ajouté RunAPI comme fournisseur custom:runapi, la même clé gère les requêtes vidéo Runway — aucune configuration de fournisseur supplémentaire requise.
2. **Appeler Runway text_to_video** — Envoyez un POST à l'endpoint text_to_video avec le modèle défini sur runway, un prompt, duration_seconds (5 ou 10) et output_resolution (720p ou 1080p). Hermes Agent peut construire cette requête via le fournisseur custom:runapi. Ajoutez first_frame_image_url pour ancrer le plan d'ouverture.
3. **Obtenir le résultat** — L'endpoint retourne immédiatement un task_id. Interrogez l'endpoint de statut de tâche jusqu'à ce que le statut soit completed, puis lisez l'URL de la vidéo de sortie depuis la réponse. Pour prolonger le clip, appelez extend_video avec le source_task_id.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Requis. Utilisez runway pour Gen-4, ou runway-aleph pour Aleph edit_video. |
| `prompt` | `string` | Requis. Description textuelle du contenu vidéo — mouvement de caméra, scène, éclairage. |
| `duration_seconds` | `integer` | Requis. Durée de la vidéo : 5 ou 10 secondes. |
| `output_resolution` | `string` | Requis. Résolution de sortie : 720p ou 1080p. Affecte la tarification. |
| `first_frame_image_url` | `string` | Optionnel. URL d'une image à utiliser comme premier plan de la vidéo. |
| `aspect_ratio` | `string` | Optionnel. Ratio d'aspect de sortie : 16:9, 9:16, 1:1, 4:3 ou 3:4. |
| `callback_url` | `string` | Optionnel. URL webhook qui reçoit un POST lorsque la tâche se termine. |

## FAQ

### Puis-je utiliser la génération vidéo Runway dans Hermes Agent ?

Oui. Hermes Agent peut appeler l'endpoint RunAPI Runway via le fournisseur custom:runapi. Définissez RUNAPI_API_KEY dans votre environnement et envoyez un POST à /api/v1/runway/text_to_video avec le modèle défini sur runway, un prompt, la durée et la résolution.

### Quelle est la différence entre Runway Gen-4 et Runway Aleph ?

Runway Gen-4 (modèle : runway) gère text_to_video et extend_video — générant de nouveaux clips depuis du texte ou des images. Runway Aleph (modèle : runway-aleph) gère edit_video — restylisant des séquences existantes avec un prompt textuel et source_video_url. Les deux fonctionnent avec la même clé RunAPI.

### Comment fonctionne la tarification Runway sur RunAPI ?

Runway utilise une facturation matricielle basée sur duration_seconds et output_resolution. Un clip de 5 secondes en 720p coûte moins qu'un clip de 10 secondes en 1080p. Consultez la page de tarification RunAPI pour les tarifs actuels. Facturation à la seconde, sans abonnement requis.

### Puis-je utiliser first_frame_image_url pour la génération image-to-video ?

Oui. Définissez first_frame_image_url sur une URL d'image de référence avec votre prompt textuel. Runway Gen-4 utilise cette image comme plan d'ouverture et l'anime selon votre prompt. Cela vous donne un contrôle précis sur la composition de départ.

### La génération Runway est-elle synchrone ou asynchrone ?

Asynchrone. L'endpoint de création retourne immédiatement un task_id. La génération vidéo prend généralement 30 à 120 secondes selon la durée et la résolution. Interrogez l'endpoint de statut de tâche ou fournissez un callback_url pour recevoir un webhook lorsque la vidéo est prête.


## Links

- [Guide de configuration Hermes Agent →](https://runapi.ai/fr/hermes-agent)
- [Runway sur RunAPI →](https://runapi.ai/fr/models/runway)
- [Model catalog](https://runapi.ai/fr/models)
- [API docs](https://runapi.ai/fr/docs)