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

# Utiliser Kling dans Hermes Agent.

Kling 3.0 de Kuaishou génère des vidéos à partir de texte ou d'images jusqu'à 1080p avec audio natif, scènes multi-plans et durées de 3 à 15 secondes. Hermes Agent l'appelle via RunAPI en utilisant le fournisseur custom:runapi — même clé et URL de base que celles configurées pour le chat.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/kling/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0",
    "prompt": "A drone shot pulling back from a mountain lake at sunrise, mist rising off the water, cinematic lighting",
    "duration_seconds": 5,
    "aspect_ratio": "16:9",
    "enable_sound": true,
    "output_resolution": "1080p"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "kling-3.0"
}

```

## How it works

1. **Configurer RunAPI** — Définissez la variable d'environnement RUNAPI_API_KEY. Si vous avez déjà ajouté RunAPI comme fournisseur custom:runapi dans Hermes Agent pour le chat, la même clé et base_url fonctionnent pour la génération vidéo — aucune configuration supplémentaire requise.
2. **Appeler Kling text_to_video** — Envoyez un POST à /api/v1/kling/text_to_video avec le modèle défini sur kling-3.0. Incluez un prompt, duration_seconds (3–15), aspect_ratio et optionnellement enable_sound pour l'audio natif. Pour la génération guidée par image, utilisez /api/v1/kling/image_to_video avec un first_frame_image_url à la place.
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 depuis la réponse. La génération prend généralement 30 à 120 secondes selon la durée et la résolution.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Requis. kling-3.0 pour la dernière version. |
| `prompt` | `string` | Description de la vidéo. Requis sauf si multi_shots est activé. |
| `duration_seconds` | `integer` | Durée de la vidéo. Kling 3.0 supporte 3–15 secondes. Les versions anciennes acceptent 5 ou 10. |
| `aspect_ratio` | `string` | Rapport d'aspect de sortie : 16:9, 9:16 ou 1:1. |
| `output_resolution` | `string` | Résolution : 720p, 1080p ou 4k. Une résolution plus élevée coûte plus cher à la seconde. |
| `enable_sound` | `boolean` | Générer de l'audio natif en parallèle de la vidéo. Augmente le coût à la seconde. |
| `negative_prompt` | `string` | Éléments à exclure de la génération. |
| `first_frame_image_url` | `string` | URL de l'image à utiliser comme premier plan (mode plan unique). |
| `cfg_scale` | `number` | Échelle de guidage (0–1). Des valeurs plus élevées suivent le prompt plus fidèlement. |
| `multi_shots` | `boolean` | Activer la génération de scènes multi-plans avec des prompts séparés par segment. |

## FAQ

### Comment fonctionne la facturation à la seconde de Kling sur RunAPI ?

Kling facture à la seconde de vidéo générée. Le tarif dépend de output_resolution et de l'activation de enable_sound. Un clip 720p de 5 secondes sans son est l'option la moins chère ; 1080p avec son coûte environ deux fois plus par seconde. Consultez la page des tarifs RunAPI pour les tarifs exacts.

### Quelle est la différence entre text_to_video et image_to_video ?

text_to_video génère un clip à partir d'un prompt texte uniquement. image_to_video requiert un first_frame_image_url et anime à partir de cette image. Les deux endpoints retournent un task_id asynchrone et supportent les mêmes options de durée et de résolution.

### Puis-je utiliser d'autres versions de Kling que la 3.0 ?

Oui. RunAPI héberge également kling-v2.5-turbo-text-to-video-pro et kling-v2.5-turbo-image-to-video-pro pour une génération plus rapide et moins coûteuse à 5 ou 10 secondes. Définissez le paramètre model sur le slug de version souhaité.

### Hermes Agent a-t-il besoin d'un fournisseur séparé pour la vidéo Kling ?

Non. Si vous avez déjà configuré le fournisseur custom:runapi dans Hermes Agent pour le chat ou la génération d'images, la même base_url et clé API fonctionnent pour les endpoints vidéo de Kling. Changez simplement le chemin de la requête et le paramètre model.

### Que se passe-t-il si la génération Kling échoue — suis-je quand même facturé ?

Non. RunAPI ne facture que les générations réussies. Si la tâche échoue ou expire en amont, les crédits réservés sont restitués à votre solde de compte.


## Links

- [Guide de configuration Hermes Agent →](https://runapi.ai/fr/hermes-agent)
- [Modèles Kling →](https://runapi.ai/fr/models/kling)
- [Model catalog](https://runapi.ai/fr/models)
- [API docs](https://runapi.ai/fr/docs)