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

# Usa Runway in Hermes Agent.

Runway Gen-4 genera video da 5 o 10 secondi a 720p o 1080p da un prompt testuale o un'immagine come primo fotogramma. Hermes Agent lo chiama tramite l'endpoint personalizzato RunAPI — configura custom:runapi una volta sola, invia text_to_video con durata e risoluzione, e fai il polling per il video finale. Estendi clip con extend_video, o usa Runway Aleph per l'editing 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. **Configura RunAPI** — Imposta RUNAPI_API_KEY nell'ambiente in cui gira Hermes Agent. Se hai già aggiunto RunAPI come provider custom:runapi, la stessa key gestisce le richieste video di Runway — nessuna configurazione aggiuntiva del provider necessaria.
2. **Chiama Runway text_to_video** — Invia una POST all'endpoint text_to_video con model impostato su runway, un prompt, duration_seconds (5 o 10) e output_resolution (720p o 1080p). Hermes Agent può costruire questa richiesta tramite il provider custom:runapi. Aggiungi first_frame_image_url per ancorare il fotogramma iniziale.
3. **Ottieni il risultato** — L'endpoint restituisce immediatamente un task_id. Esegui il polling dell'endpoint di stato del task finché lo stato non è completed, poi leggi l'URL del video di output dalla risposta. Per estendere il clip, chiama extend_video con il source_task_id.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obbligatorio. Usa runway per Gen-4, o runway-aleph per Aleph edit_video. |
| `prompt` | `string` | Obbligatorio. Descrizione testuale del contenuto video — movimento della telecamera, scena, illuminazione. |
| `duration_seconds` | `integer` | Obbligatorio. Durata del video: 5 o 10 secondi. |
| `output_resolution` | `string` | Obbligatorio. Risoluzione di output: 720p o 1080p. Influisce sul prezzo. |
| `first_frame_image_url` | `string` | Facoltativo. URL di un'immagine da usare come primo fotogramma del video. |
| `aspect_ratio` | `string` | Facoltativo. Rapporto d'aspetto di output: 16:9, 9:16, 1:1, 4:3, o 3:4. |
| `callback_url` | `string` | Facoltativo. URL webhook che riceve una POST quando il task si completa. |

## FAQ

### Posso usare la generazione video di Runway in Hermes Agent?

Sì. Hermes Agent può chiamare l'endpoint Runway di RunAPI tramite il provider custom:runapi. Imposta RUNAPI_API_KEY nel tuo ambiente e invia una POST a /api/v1/runway/text_to_video con model impostato su runway, un prompt, la durata e la risoluzione.

### Qual è la differenza tra Runway Gen-4 e Runway Aleph?

Runway Gen-4 (model: runway) gestisce text_to_video ed extend_video — generando nuovi clip da testo o immagini. Runway Aleph (model: runway-aleph) gestisce edit_video — modificando lo stile di filmati esistenti con un prompt testuale e source_video_url. Entrambi girano tramite la stessa API key RunAPI.

### Come funziona il prezzo di Runway su RunAPI?

Runway usa una tariffazione a matrice basata su duration_seconds e output_resolution. Un clip da 5 secondi a 720p costa meno di uno da 10 secondi a 1080p. Controlla la pagina dei prezzi di RunAPI per le tariffe aggiornate. Fatturazione al secondo, nessun abbonamento richiesto.

### Posso usare first_frame_image_url per la generazione image-to-video?

Sì. Imposta first_frame_image_url con l'URL di un'immagine di riferimento insieme al tuo prompt testuale. Runway Gen-4 usa quell'immagine come fotogramma iniziale e la anima secondo il tuo prompt. Questo ti dà un controllo preciso sulla composizione iniziale.

### La generazione Runway è sincrona o asincrona?

Asincrono. L'endpoint di creazione restituisce immediatamente un task_id. La generazione video richiede tipicamente 30-120 secondi in base alla durata e alla risoluzione. Esegui il polling dell'endpoint di stato del task o fornisci un callback_url per ricevere un webhook quando il video è pronto.


## Links

- [Guida di configurazione di Hermes Agent →](https://runapi.ai/it/hermes-agent)
- [Runway su RunAPI →](https://runapi.ai/it/models/runway)
- [Model catalog](https://runapi.ai/it/models)
- [API docs](https://runapi.ai/it/docs)