在 Hermes Agent 中使用 Runway。
Runway Gen-4 可根据文本提示词或首帧图像，以 720p 或 1080p 生成 5 秒或 10 秒的视频。Hermes Agent 通过 RunAPI 自定义端点调用它 —— 一次性配置 custom:runapi，发送带时长和分辨率的 text_to_video，然后轮询获取完成的视频。使用 extend_video 扩展片段，或使用 Runway Aleph 进行视频转视频编辑。
Use RunAPI to generate a video with Runway Gen-4.
要求：
- 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"
}
三步在 Hermes Agent 中使用 Runway
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 参数
| 参数 | 类型 | 说明 |
|---|---|---|
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. |
Hermes Agent 上的 Runway 是什么？
Runway Gen-4 以电影感构图和流畅运动效果提供制作级视频。通过 Hermes Agent 的 custom:runapi provider，可生成 5 秒或 10 秒、720p 或 1080p 的视频，带有世界一致性和跨镜头角色一致性。Runway Aleph 为现有素材重新设定风格提供了视频转视频编辑功能。
Runway 使用场景
带一致角色的叙事内容
构建角色在各片段间保持外观的多镜头视频序列。使用参考图像锁定角色细节，由 Hermes Agent 负责串联各个镜头。
广告与社交内容制作
大批量生成 Instagram Reels、TikTok 短片和微广告。Hermes Agent 可并行分发多个 Runway 任务，使用不同提示词并收集所有结果。
用 Aleph 进行视频风格重置
使用 Runway Aleph 改造现有素材——在保留原始运动的同时改变视觉风格、光效或环境。传入 source_video_url 和风格提示词即可重置素材风格。
Runway + Hermes Agent 常见问题
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 中试用 Runway。
免费获取 RunAPI 密钥，配置 custom:runapi provider，使用 Runway Gen-4 以 720p 或 1080p 生成电影级视频。