---
title: "透過 RunAPI 在 OpenClaw 中使用 Runway — 影片生成 API"
url: "https://runapi.ai/zh-TW/openclaw-runway.md"
canonical: "https://runapi.ai/zh-TW/openclaw-runway"
locale: "zh-TW"
model: "runway"
---

# 在 OpenClaw 中使用 Runway。

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

## API example

```bash
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"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "runway"
}

```

## How it works

1. **設定 RunAPI** — 在環境中設定 RUNAPI_API_KEY。如果你已在 OpenClaw 中為聊天設定了 RunAPI，同一把 key 即可用於 Runway 影片生成 — 無需額外 provider 設定。
2. **呼叫 Runway text_to_video** — 向 text_to_video 端點發送 POST 請求，將 model 設為 runway、附上 prompt、duration_seconds（5 或 10）與 output_resolution（720p 或 1080p）。加入 first_frame_image_url 可將開場幀錨定至參考圖片。
3. **輪詢結果** — 端點會立即回傳 task_id。輪詢任務狀態端點，直到狀態為 completed，再從回應中讀取輸出影片 URL。若要延伸片段，使用 source_task_id 呼叫 extend_video。

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `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。 |

## FAQ

### 我可以在 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 通知。


## Links

- [OpenClaw 設定指南 →](https://runapi.ai/zh-TW/openclaw)
- [Runway on RunAPI →](https://runapi.ai/zh-TW/models/runway)
- [Model catalog](https://runapi.ai/zh-TW/models)
- [API docs](https://runapi.ai/zh-TW/docs)