Use Runway in Hermes Agent.
Runway Gen-4 generates 5-second or 10-second videos at 720p or 1080p from a text prompt or a first-frame image. Hermes Agent calls it through the RunAPI custom endpoint — configure custom:runapi once, send text_to_video with a duration and resolution, and poll for the finished video. Extend clips with extend_video, or use Runway Aleph for video-to-video editing.
Use RunAPI to generate a video with Runway Gen-4.
Requirements:
- Read the API key from RUNAPI_API_KEY.
- Use the custom:runapi provider with base_url https://runapi.ai/v1.
- Call POST https://runapi.ai/api/v1/runway/text_to_video
- Set model to "runway".
- Set prompt to describe the video content.
- Set duration_seconds to 5 or 10.
- Set output_resolution to "720p" or "1080p".
- Optionally set first_frame_image_url to guide the opening frame.
- The task is async. Poll the returned task_id until status is "completed".
- When done, read the video URL from the response output.
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"
}
Use Runway in Hermes Agent in three steps
Configure RunAPI
Set RUNAPI_API_KEY in the environment where Hermes Agent runs. If you already added RunAPI as a custom:runapi provider, the same key handles Runway video requests — no additional provider configuration needed.
export RUNAPI_API_KEY=runapi_xxx
Call Runway text_to_video
Send a POST to the text_to_video endpoint with model set to runway, a prompt, duration_seconds (5 or 10), and output_resolution (720p or 1080p). Hermes Agent can build this request through the custom:runapi provider. Add first_frame_image_url to anchor the opening frame.
POST /api/v1/runway/text_to_video
Poll for the result
The endpoint returns a task_id immediately. Poll the task status endpoint until the status is completed, then read the output video URL from the response. To extend the clip, call extend_video with the source_task_id.
GET /api/v1/runway/text_to_video/tsk_abc123
Runway text_to_video API parameters
| Parameter | Type | Description |
|---|---|---|
model |
string |
Required. Use runway for Gen-4, or runway-aleph for Aleph edit_video. |
prompt |
string |
Required. Text description of the video content — camera motion, scene, lighting. |
duration_seconds |
integer |
Required. Video length: 5 or 10 seconds. |
output_resolution |
string |
Required. Output resolution: 720p or 1080p. Affects pricing. |
first_frame_image_url |
string |
Optional. URL of an image to use as the first frame of the video. |
aspect_ratio |
string |
Optional. Output aspect ratio: 16:9, 9:16, 1:1, 4:3, or 3:4. |
callback_url |
string |
Optional. Webhook URL that receives a POST when the task completes. |
What is Runway on Hermes Agent?
Runway Gen-4 delivers production-grade video with cinematic framing and smooth motion, earning a reputation for quick, clean output. Through the Hermes Agent custom:runapi provider, it generates 5 or 10 second clips at 720p or 1080p with world consistency and character consistency across shots. Runway Aleph adds video-to-video editing for restyling existing footage.
Runway use cases
Narrative content with consistent characters
Build multi-shot video sequences where characters maintain their appearance across clips. Use reference images to lock down character details and Hermes Agent chains the shots together.
Ad and social content production
Generate Instagram Reels, TikTok clips, and micro-ads at scale. Hermes Agent can dispatch multiple Runway tasks in parallel with different prompts and collect all results.
Video restyling with Aleph
Transform existing footage with Runway Aleph -- change visual style, lighting, or environment while preserving the original motion. Pass a source_video_url and a style prompt to restyle the clip.
Runway + Hermes Agent questions
Yes. Hermes Agent can call the RunAPI Runway endpoint through the custom:runapi provider. Set RUNAPI_API_KEY in your environment and send a POST to /api/v1/runway/text_to_video with model set to runway, a prompt, duration, and resolution.
Runway Gen-4 (model: runway) handles text_to_video and extend_video — generating new clips from text or images. Runway Aleph (model: runway-aleph) handles edit_video — restyling existing footage with a text prompt and source_video_url. Both run through the same RunAPI key.
Yes. Runway Gen-4 produces production-grade clips with cinematic framing that many YouTubers use for intros, B-rolls, and short ad segments. The 5 or 10 second duration covers most insert-clip needs. For longer sequences, chain multiple generations using first_frame_image_url for continuity.
Include the first_frame_image_url in your request body when calling the Runway endpoint through Hermes Agent. The custom:runapi provider passes it directly. Hermes Agent can also generate the first frame with an image model, then feed the URL to Runway automatically.
Yes. Hermes Agent can select the Runway model based on your requirements -- Gen-4 for creating new clips from text or images, Aleph for editing and restyling existing footage. Set the model parameter in each request to switch between them.
Hermes Agent general setup
Not configured yet? Start with the RunAPI setup guide for Hermes Agent.
Hermes Agent setup guide →Try Runway in Hermes Agent today.
Get a free RunAPI key, configure the custom:runapi provider, and generate cinematic video with Runway Gen-4 at 720p or 1080p.