Can I use Runway video generation in OpenClaw?

Yes. OpenClaw agents can call the RunAPI Runway endpoint directly. Configure RunAPI with your RUNAPI_API_KEY, then send a POST to /api/v1/runway/text_to_video with model set to runway, a prompt, duration, and resolution.

What is the difference between Runway Gen-4 and Runway Aleph?

Runway Gen-4 (model: runway) handles text_to_video and extend_video. Runway Aleph (model: runway-aleph) handles edit_video — transforming an existing source video with a text prompt. Use Gen-4 for creating new video from scratch, Aleph for restyling existing footage.

How does Runway pricing work on RunAPI?

Runway uses matrix billing based on duration_seconds and output_resolution. A 5-second 720p clip costs less than a 10-second 1080p clip. Check the RunAPI pricing page for current rates. Per-second billing, no subscription required.

Can I extend a Runway video after generating it?

Yes. Call the extend_video endpoint with the source_task_id from the original generation and a new prompt. The extension appends to the existing clip. Extend pricing is per-clip based on output_resolution.

Is Runway generation synchronous or asynchronous?

Asynchronous. The create endpoint returns a task_id immediately. Video generation typically takes 30–120 seconds depending on duration and resolution. Poll the task status endpoint or provide a callback_url to receive a webhook when the video is ready.

OPENCLAW + RUNWAY

在 OpenClaw 中使用 Runway。

Runway Gen-4 可根据文本提示词或首帧图像，以 720p 或 1080p 生成 5 秒或 10 秒的视频。OpenClaw 智能体使用与聊天相同的 RunAPI 密钥调用它 —— 发送带时长和分辨率的 text_to_video，轮询任务，即可获得视频 URL。使用 extend_video 扩展现有片段，或使用 Runway Aleph 进行视频转视频编辑。

获取 API Key 阅读文档

一个 API 密钥 · 文生视频端点 · 720p 或 1080p 输出

Use RunAPI to generate a video with Runway Gen-4.

要求：
- Read the API key from RUNAPI_API_KEY.
- 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"
}

复制 curl 命令进行测试 runway

工作原理

三步在 OpenClaw 中使用 Runway

Configure RunAPI

Set RUNAPI_API_KEY in your environment. If you already configured RunAPI for chat in OpenClaw, the same key works for Runway video generation — no extra provider setup 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). Add first_frame_image_url to anchor the opening frame to a reference image.

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.

OpenClaw 上的 Runway 是什么？

Runway Gen-4 以快速、干净的电影级输出、流畅的运动效果和出色的提示词遵从性著称。它生成 5 秒或 10 秒、720p 或 1080p 的视频片段，带有世界一致性和跨镜头角色一致性。Runway Aleph 则为现有素材添加了视频转视频编辑功能。OpenClaw agent 通过 RunAPI 调用它，使用与聊天相同的 API key。