---
title: "Usa Runway in OpenClaw tramite RunAPI — API di Generazione Video"
url: "https://runapi.ai/it/openclaw-runway.md"
canonical: "https://runapi.ai/it/openclaw-runway"
locale: "it"
model: "runway"
---

# Usa Runway in OpenClaw.

Runway Gen-4 genera video da 5 o 10 secondi a 720p o 1080p da un prompt testuale o un'immagine come primo fotogramma. Gli agenti OpenClaw lo chiamano tramite la stessa API key RunAPI usata per la chat — invia text_to_video con durata e risoluzione, fai il polling del task e ricevi un URL video. Estendi clip esistenti 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 nel tuo ambiente. Se hai già configurato RunAPI per la chat in OpenClaw, la stessa key funziona per la generazione 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). Aggiungi first_frame_image_url per ancorare il fotogramma iniziale a un'immagine di riferimento.
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 OpenClaw?

Sì. Gli agenti OpenClaw possono chiamare direttamente l'endpoint Runway di RunAPI. Configura RunAPI con la tua RUNAPI_API_KEY, poi 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. Runway Aleph (model: runway-aleph) gestisce edit_video — trasformando un video sorgente esistente con un prompt testuale. Usa Gen-4 per creare nuovo video da zero, Aleph per modificare lo stile di filmati esistenti.

### 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 estendere un video Runway dopo averlo generato?

Sì. Chiama l'endpoint extend_video con il source_task_id della generazione originale e un nuovo prompt. L'estensione si aggiunge al clip esistente. Il prezzo dell'estensione è per clip in base a output_resolution.

### 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 OpenClaw →](https://runapi.ai/it/openclaw)
- [Runway su RunAPI →](https://runapi.ai/it/models/runway)
- [Model catalog](https://runapi.ai/it/models)
- [API docs](https://runapi.ai/it/docs)