---
title: "Usa Kling in Hermes Agent tramite RunAPI — Guida API Video"
url: "https://runapi.ai/it/hermes-kling.md"
canonical: "https://runapi.ai/it/hermes-kling"
locale: "it"
model: "kling"
---

# Usa Kling in Hermes Agent.

Kling 3.0 di Kuaishou genera video da testo o immagini fino a 1080p con audio nativo, scene multi-shot e durate da 3 a 15 secondi. Hermes Agent lo chiama tramite RunAPI usando il provider custom:runapi — stessa key e base URL configurate per la 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. **Configura RunAPI** — Imposta la variabile d'ambiente RUNAPI_API_KEY. Se hai già aggiunto RunAPI come provider custom:runapi in Hermes Agent per la chat, la stessa key e base_url funzionano per la generazione video — nessuna configurazione aggiuntiva necessaria.
2. **Chiama Kling text_to_video** — Invia una richiesta POST a /api/v1/kling/text_to_video con model impostato su kling-3.0. Includi un prompt, duration_seconds (3–15), aspect_ratio e facoltativamente enable_sound per l'audio nativo. Per la generazione guidata da immagine, usa /api/v1/kling/image_to_video con un first_frame_image_url.
3. **Ottieni il risultato** — L'endpoint restituisce subito un task_id. Esegui il polling dell'endpoint di stato del task finché lo stato non cambia in completed, poi recupera l'URL video dalla risposta. La generazione richiede tipicamente 30–120 secondi in base alla durata e alla risoluzione.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obbligatorio. kling-3.0 per la versione più recente. |
| `prompt` | `string` | Descrizione del video. Obbligatorio salvo se multi_shots è attivo. |
| `duration_seconds` | `integer` | Durata del video. Kling 3.0 supporta 3–15 secondi. Le versioni precedenti accettano 5 o 10. |
| `aspect_ratio` | `string` | Rapporto d'aspetto dell'output: 16:9, 9:16 o 1:1. |
| `output_resolution` | `string` | Risoluzione: 720p, 1080p o 4k. Risoluzioni più alte costano di più per secondo. |
| `enable_sound` | `boolean` | Genera audio nativo insieme al video. Aumenta il costo al secondo. |
| `negative_prompt` | `string` | Elementi da escludere dalla generazione. |
| `first_frame_image_url` | `string` | URL dell'immagine da usare come primo fotogramma (modalità single-shot). |
| `cfg_scale` | `number` | Scala di guida (0–1). Valori più alti seguono il prompt più fedelmente. |
| `multi_shots` | `boolean` | Abilita la generazione di scene multi-shot con prompt separati per segmento. |

## FAQ

### Come funziona la fatturazione al secondo di Kling su RunAPI?

Kling addebita per secondo di video generato. La tariffa dipende da output_resolution e se enable_sound è attivo. Un clip da 5 secondi a 720p senza audio è l'opzione più economica; 1080p con audio costa circa il doppio per secondo. Controlla la pagina dei prezzi di RunAPI per le tariffe esatte.

### Qual è la differenza tra text_to_video e image_to_video?

text_to_video genera un clip da un solo prompt testuale. image_to_video richiede un first_frame_image_url e anima a partire da quell'immagine. Entrambi gli endpoint restituiscono un task_id asincrono e supportano le stesse opzioni di durata e risoluzione.

### Posso usare altre versioni di Kling oltre alla 3.0?

Sì. RunAPI ospita anche kling-v2.5-turbo-text-to-video-pro e kling-v2.5-turbo-image-to-video-pro per una generazione più rapida e a costo inferiore a 5 o 10 secondi. Imposta il parametro model allo slug della versione desiderata.

### Hermes Agent ha bisogno di un provider separato per i video Kling?

No. Se hai già configurato il provider custom:runapi in Hermes Agent per la chat o la generazione di immagini, la stessa base_url e API key funzionano per gli endpoint video Kling. Cambia solo il percorso della richiesta e il parametro model.

### Cosa succede se la generazione Kling fallisce — vengo comunque addebitato?

No. RunAPI addebita solo per le generazioni completate. Se il task fallisce o va in timeout, i crediti prenotati vengono restituiti al saldo del tuo account.


## Links

- [Guida di configurazione di Hermes Agent →](https://runapi.ai/it/hermes-agent)
- [Modelli Kling →](https://runapi.ai/it/models/kling)
- [Model catalog](https://runapi.ai/it/models)
- [API docs](https://runapi.ai/it/docs)