我可以在 OpenClaw 中使用 Runway 影片生成嗎？

可以。OpenClaw agent 可以直接呼叫 RunAPI Runway 端點。使用你的 RUNAPI_API_KEY 設定 RunAPI，然後向 /api/v1/runway/text_to_video 發送 POST 請求，將 model 設為 runway，並附上 prompt、時長與解析度。

Runway Gen-4 與 Runway Aleph 有什麼差別？

Runway Gen-4（model: runway）處理 text_to_video 與 extend_video。Runway Aleph（model: runway-aleph）處理 edit_video — 使用文字提示重新風格化現有來源影片。使用 Gen-4 從頭創建新影片，使用 Aleph 重新設計現有素材。

Runway 在 RunAPI 上的計費方式如何？

Runway 採用基於 duration_seconds 與 output_resolution 的矩陣計費。5 秒 720p 片段的費用低於 10 秒 1080p 片段。請查看 RunAPI 定價頁面以了解最新費率。按秒計費，無需訂閱。

生成後可以延伸 Runway 影片嗎？

可以。使用原始生成的 source_task_id 與新 prompt 呼叫 extend_video 端點。延伸會附加到現有片段之後。延伸費用按片段計算，取決於 output_resolution。

Runway 生成是同步還是非同步？

非同步。建立端點會立即回傳 task_id。影片生成通常需要 30–120 秒，取決於時長與解析度。輪詢任務狀態端點或提供 callback_url 以在影片就緒時接收 Webhook 通知。

OPENCLAW + RUNWAY

在 OpenClaw 中使用 Runway。

Runway Gen-4 可從文字提示或首幀圖片生成 5 秒或 10 秒的 720p 或 1080p 影片。OpenClaw agent 透過與聊天相同的 RunAPI key 呼叫 — 送出 text_to_video 並指定時長與解析度，輪詢任務後即可取得影片 URL。透過 extend_video 延伸現有片段，或使用 Runway Aleph 進行影片對影片編輯。

取得 API Key 閱讀文件

一個 API key · 文生影片端點 · 720p 或 1080p 輸出

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

Requirements:
- 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

設定 RunAPI

在環境中設定 RUNAPI_API_KEY。如果你已在 OpenClaw 中為聊天設定了 RunAPI，同一把 key 即可用於 Runway 影片生成 — 無需額外 provider 設定。

export RUNAPI_API_KEY=runapi_xxx

呼叫 Runway text_to_video

向 text_to_video 端點發送 POST 請求，將 model 設為 runway、附上 prompt、duration_seconds（5 或 10）與 output_resolution（720p 或 1080p）。加入 first_frame_image_url 可將開場幀錨定至參考圖片。

POST /api/v1/runway/text_to_video

輪詢結果

端點會立即回傳 task_id。輪詢任務狀態端點，直到狀態為 completed，再從回應中讀取輸出影片 URL。若要延伸片段，使用 source_task_id 呼叫 extend_video。

GET /api/v1/runway/text_to_video/tsk_abc123

參數

Runway text_to_video API 參數

參數	類型	說明
`model`	`string`	必填。Gen-4 使用 runway，Aleph edit_video 使用 runway-aleph。
`prompt`	`string`	必填。影片內容的文字描述 — 鏡頭運動、場景、燈光。
`duration_seconds`	`integer`	必填。影片長度：5 或 10 秒。
`output_resolution`	`string`	必填。輸出解析度：720p 或 1080p。影響價格。
`first_frame_image_url`	`string`	選填。作為影片第一幀的圖片 URL。
`aspect_ratio`	`string`	選填。輸出寬高比：16:9、9:16、1:1、4:3 或 3:4。
`callback_url`	`string`	選填。任務完成時接收 POST 通知的 Webhook URL。

OpenClaw 上的 Runway 是什麼？

Runway Gen-4 以快速、乾淨的電影級輸出、流暢的運動效果和出色的提示詞遵從性著稱。它生成 5 秒或 10 秒、720p 或 1080p 的影片片段，帶有世界一致性和跨鏡頭角色一致性。Runway Aleph 則為現有素材添加了影片轉影片編輯功能。OpenClaw agent 通過 RunAPI 呼叫它，使用與聊天相同的 API key。