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.
Usa RunAPI per generare un video con Runway Gen-4.
Requisiti:
- Leggi l'API key da RUNAPI_API_KEY.
- Usa il provider custom:runapi con base_url https://runapi.ai/v1.
- Chiama POST https://runapi.ai/api/v1/runway/text_to_video
- Imposta model su "runway".
- Imposta prompt per descrivere il contenuto del video.
- Imposta duration_seconds a 5 o 10.
- Imposta output_resolution su "720p" o "1080p".
- Facoltativamente imposta first_frame_image_url per guidare il fotogramma iniziale.
- Il task è asincrono. Esegui il polling del task_id restituito finché lo stato non è "completed".
- Al termine, leggi l'URL del video dall'output della risposta.
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"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "runway"
}
Usa Runway in Hermes Agent in tre passaggi
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.
export RUNAPI_API_KEY=runapi_xxx
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.
POST /api/v1/runway/text_to_video
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.
GET /api/v1/runway/text_to_video/tsk_abc123
Parametri API Runway text_to_video
| Parametro | Tipo | Descrizione |
|---|---|---|
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. |
Cos'è Runway su Hermes Agent?
Runway Gen-4 offre video di qualità produzione con framing cinematografico e movimento fluido, guadagnandosi una reputazione per output rapido e pulito. Tramite il provider custom:runapi di Hermes Agent, genera clip da 5 o 10 secondi a 720p o 1080p con coerenza del mondo e dei personaggi tra gli shot. Runway Aleph aggiunge l'editing video-a-video per il re-styling dei filmati esistenti.
Casi d'uso di Runway
Contenuto narrativo con personaggi coerenti
Costruire sequenze video multi-shot dove i personaggi mantengono il loro aspetto tra i clip. Usare immagini di riferimento per fissare i dettagli dei personaggi e Hermes Agent concatena gli shot.
Produzione di annunci e contenuto social
Generare Instagram Reels, clip TikTok e micro-annunci su larga scala. Hermes Agent può inviare più task Runway in parallelo con prompt diversi e raccogliere tutti i risultati.
Re-styling video con Aleph
Trasformare i filmati esistenti con Runway Aleph -- cambiare lo stile visivo, l'illuminazione o l'ambiente preservando il movimento originale. Passare una source_video_url e un prompt di stile per il re-styling del clip.
Domande su Runway + 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.
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.
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.
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.
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.
Configurazione generale di Hermes Agent
Non ancora configurato? Inizia con la guida di configurazione RunAPI per Hermes Agent.
Guida di configurazione di Hermes Agent →Catalogo modelli Runway
Vedi le varianti Gen-4 e Aleph di Runway, i prezzi e la documentazione API.
Runway su RunAPI →Prova Runway in Hermes Agent oggi.
Ottieni una API key RunAPI gratuita, configura il provider custom:runapi e genera video cinematografici con Runway Gen-4 a 720p o 1080p.