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

# Utiliser Veo 3 dans Hermes Agent.

Veo 3 est le modèle de génération vidéo de Google DeepMind qui produit des clips 1080p jusqu'à 8 secondes avec audio natif — dialogue synchronisé, sons ambiants et musique générés en même temps que la vidéo. Hermes Agent l'appelle via l'endpoint fournisseur personnalisé RunAPI, réutilisant la même clé API configurée pour le chat.

## 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. **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 pour le chat, la même clé et base_url gèrent la génération vidéo — aucun identifiant Google Cloud séparé requis.
2. **Appeler Veo 3 text_to_video** — Envoyez un POST à l'endpoint text_to_video avec le modèle défini sur veo-3.1. Incluez un prompt avec des descriptions de scène et des indices audio (dialogue, sons ambiants). Définissez duration_seconds sur 4, 6 ou 8 et aspect_ratio sur 16:9 ou 9:16. Hermes Agent achemine les requêtes 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 passe à completed, puis récupérez l'URL de la vidéo de sortie. La vidéo inclut de l'audio synchronisé généré à partir de votre prompt.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Requis. veo-3.1 (qualité standard) ou veo-3.1-fast (coût inférieur, génération plus rapide). |
| `prompt` | `string` | Requis. Description de la scène incluant l'action visuelle, le mouvement de caméra et les indices audio pour le dialogue ou les sons ambiants. |
| `duration_seconds` | `integer` | Optionnel. Durée de la vidéo en secondes. Valeurs acceptées : 4, 6, 8. Par défaut 8. |
| `aspect_ratio` | `string` | Optionnel. Rapport d'aspect de sortie. Valeurs acceptées : 16:9, 9:16, auto. |
| `input_mode` | `string` | Optionnel. Mode de génération. text (par défaut), first_and_last_frames (guidé par images-clés) ou reference (référence de style). |
| `first_frame_image_url` | `string` | Optionnel. URL de l'image du premier plan. Utilisé quand input_mode est first_and_last_frames. |
| `last_frame_image_url` | `string` | Optionnel. URL de l'image du dernier plan. Utilisé quand input_mode est first_and_last_frames. |
| `reference_image_urls` | `array` | Optionnel. URLs des images de référence de style. Utilisé quand input_mode est reference. |
| `callback_url` | `string` | Optionnel. URL webhook qui reçoit un POST lorsque la tâche se termine. |

## FAQ

### Puis-je utiliser Veo 3 dans Hermes Agent ?

Oui. Hermes Agent appelle l'endpoint text_to_video de Veo 3 via le fournisseur custom:runapi. Définissez le modèle sur veo-3.1 et envoyez la requête avec la même RUNAPI_API_KEY utilisée pour le chat. Aucun compte Google Cloud ni identifiants vidéo séparés requis.

### Comment le fournisseur custom:runapi gère-t-il les tâches vidéo asynchrones ?

RunAPI retourne un task_id immédiatement à la requête POST initiale. Votre workflow Hermes Agent interroge l'endpoint de statut de tâche jusqu'à ce que le statut soit completed, puis lit l'URL de la vidéo de sortie. Vous pouvez également définir callback_url pour recevoir un webhook au lieu d'interroger.

### Quelle est la différence entre veo-3.1 et veo-3.1-fast ?

Les deux produisent de la vidéo avec audio natif jusqu'à 1080p. veo-3.1 utilise le pipeline qualité complète et coûte plus par génération. veo-3.1-fast sacrifie un peu de fidélité visuelle pour un coût inférieur et un rendu plus rapide — adapté aux brouillons et aux itérations.

### Puis-je contrôler le mouvement de caméra et l'audio dans Veo 3 ?

Oui. Décrivez le mouvement de caméra dans le prompt (travelling avant, plan de suivi, panoramique aérien) et Veo 3 l'interprète avec une simulation physique réaliste. Pour l'audio, incluez des dialogues entre guillemets et décrivez les sons ambiants — le modèle génère l'audio synchronisé nativement, sans TTS ni bibliothèque sonore séparée.

### Puis-je prolonger ou upscaler une vidéo Veo 3 après la génération ?

Oui. RunAPI expose les endpoints extend_video et upscale_video pour Veo 3. Passez le source_task_id de la génération originale pour prolonger le clip, ou l'upscaler en 1080p ou 4K. Les deux sont asynchrones et facturés séparément.


## Links

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