---
title: "Utiliser Luma dans Hermes Agent via RunAPI — API de Modification Vidéo"
url: "https://runapi.ai/fr/hermes-luma.md"
canonical: "https://runapi.ai/fr/hermes-luma"
locale: "fr"
model: "luma"
---

# Utiliser Luma dans Hermes Agent.

Luma Ray 3.2 modifie les vidéos existantes avec des transformations pilotées par prompt qui préservent la cohérence spatiale et la structure de scène 3D. Envoyez une URL de vidéo source et un prompt textuel décrivant la transformation — Luma re-rend les séquences avec un éclairage atmosphérique, des détails environnementaux et un mouvement de caméra physiquement cohérent. Hermes Agent l'appelle via l'endpoint personnalisé RunAPI.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/luma/modify_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "luma-modify-video",
    "prompt": "Transform the scene into a foggy autumn morning with golden light filtering through trees",
    "source_video_url": "https://example.com/park-walk.mp4"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "luma-modify-video"
}

```

## 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 de modification vidéo Luma.
2. **Appeler Luma modify_video** — Envoyez une requête POST à l'endpoint modify_video avec le modèle défini sur luma-modify-video, source_video_url pointant vers vos séquences d'entrée, et un prompt décrivant la transformation. Hermes Agent peut construire et envoyer cette requête via le fournisseur custom:runapi.
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. La modification vidéo prend généralement 30 à 120 secondes selon la complexité.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Requis. Utilisez luma-modify-video. |
| `prompt` | `string` | Requis. Description textuelle de la transformation vidéo souhaitée — changements de style, éclairage, atmosphère ou modifications de scène. |
| `source_video_url` | `string` | Requis. URL de la vidéo source à modifier. Doit être un fichier MP4 ou MOV accessible publiquement. |
| `watermark` | `boolean` | Optionnel. Indique si un filigrane doit être ajouté à la vidéo de sortie. |
| `callback_url` | `string` | Optionnel. URL webhook qui reçoit un POST lorsque la tâche se termine. |

## FAQ

### Quel type de transformations Luma modify_video peut-il effectuer ?

Luma modify_video re-rend les séquences existantes avec des modifications pilotées par prompt — changements atmosphériques (brouillard, pluie, heure dorée), transferts de style (cinématique, anime, noir), rénovations d'éclairage et transformations environnementales. Il préserve le mouvement de caméra original et la mise en page spatiale de la scène.

### Comment configurer le fournisseur custom:runapi pour Luma dans Hermes Agent ?

Ajoutez un fournisseur personnalisé nommé runapi dans votre configuration Hermes Agent avec base_url https://runapi.ai/v1 et key_env RUNAPI_API_KEY. Une fois configuré, le même fournisseur gère les appels Luma modify_video ainsi que le chat et les autres requêtes de modèles RunAPI.

### Luma modify_video est-il synchrone ou asynchrone ?

Asynchrone. L'endpoint de création retourne immédiatement un task_id. Interrogez l'endpoint de statut de tâche ou fournissez un callback_url pour recevoir un webhook lorsque la vidéo modifiée est prête. Le temps de traitement typique est de 30 à 120 secondes.

### Quel est le coût de la modification vidéo Luma sur RunAPI ?

Luma utilise une facturation forfaitaire par tâche — chaque appel modify_video coûte un montant fixe quelle que soit la durée de la vidéo. Consultez la page de tarification RunAPI pour les tarifs actuels. Les générations échouées ne sont pas facturées.

### Hermes Agent peut-il enchaîner Luma avec des modèles de génération vidéo dans un seul workflow ?

Oui. Un workflow Hermes Agent peut générer une vidéo avec Kling ou Wan, puis passer l'URL de sortie comme source_video_url à Luma modify_video pour un re-rendu atmosphérique — tout via le même fournisseur custom:runapi et RUNAPI_API_KEY. Chaque étape utilise le même modèle de polling asynchrone.


## Links

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