---
title: 透過 RunAPI 在 WorkBuddy 中使用 Runway — 影片 MCP 指南 | RunAPI
description: 透過 RunAPI MCP server 在 WorkBuddy 中使用 Runway Gen-4 生成影片。text-to-video、5 秒或 10 秒片段、720p/1080p、一組 API key。
url: https://runapi.ai/zh-TW/workbuddy-runway.md
canonical: https://runapi.ai/zh-TW/workbuddy-runway
locale: zh-TW
site: RunAPI
image: https://runapi.ai/assets/opengraph-bfaaa0f0.png
alternates:
  en: https://runapi.ai/workbuddy-runway
  zh-CN: https://runapi.ai/zh-CN/workbuddy-runway
  es: https://runapi.ai/es/workbuddy-runway
  ja: https://runapi.ai/ja/workbuddy-runway
  de: https://runapi.ai/de/workbuddy-runway
  fr: https://runapi.ai/fr/workbuddy-runway
  pt-BR: https://runapi.ai/pt-BR/workbuddy-runway
  ko: https://runapi.ai/ko/workbuddy-runway
  it: https://runapi.ai/it/workbuddy-runway
  nl: https://runapi.ai/nl/workbuddy-runway
  pl: https://runapi.ai/pl/workbuddy-runway
  tr: https://runapi.ai/tr/workbuddy-runway
  zh-TW: https://runapi.ai/zh-TW/workbuddy-runway
  zh-HK: https://runapi.ai/zh-HK/workbuddy-runway
  ar: https://runapi.ai/ar/workbuddy-runway
  x-default: https://runapi.ai/workbuddy-runway
model: runway
---

> HTML version: https://runapi.ai/zh-TW/workbuddy-runway
> Site index for agents: https://runapi.ai/llms.txt


# 在 WorkBuddy 中使用 Runway。

Runway Gen-4 可根據文字提示或第一影格圖片生成 5 秒或 10 秒、720p 或 1080p 的影片。WorkBuddy 原生支援 MCP — 只要將 RunAPI 新增為 MCP server 一次，接著要求 workbench agent 製作影片。它會呼叫 Runway 工具、等待非同步任務完成，並將完成的影片 URL 放回您的 chat 中。同樣可使用 Runway Aleph 延長片段或重新風格化影片。

- [取得 API Key](https://runapi.ai/zh-TW/login)
- [閱讀說明文件](https://runapi.ai/zh-TW/docs/guides)

一個 MCP server · 一組 RunAPI key · 720p 或 1080p 輸出

### 提示詞

```text
Generate a video with Runway Gen-4 through the runapi MCP server.

Requirements:
- Use the runapi MCP server's video generation tool.
- Set model to "runway".
- Prompt: "A drone shot rising over a misty mountain lake at sunrise, cinematic lighting".
- Set duration_seconds to 10 and output_resolution to "1080p".
- The task is async — wait for it to complete and give me the video URL.

```

### MCP 設定

```bash
{
  "mcp_servers": {
    "runapi": {
      "url": "https://runapi.ai/mcp",
      "transport": "streamable_http",
      "headers": {
        "Authorization": "Bearer $RUNAPI_API_KEY"
      }
    }
  }
}

```

### 回應

```json
{
  "task_id": "tsk_abc123",
  "status": "completed",
  "model": "runway",
  "output": {
    "video_url": "https://media.runapi.ai/videos/tsk_abc123.mp4"
  }
}

```

## 三個步驟在 WorkBuddy 中使用 Runway

1. **新增 RunAPI MCP server** - 在 WorkBuddy 中註冊名為 runapi、指向 https://runapi.ai/mcp 的 MCP server，並使用 Authorization header 從 RUNAPI_API_KEY 讀取您的 key。如果您已將 RunAPI 連接至 WorkBuddy，同一個 server 已提供 Runway 工具 — 無需額外設定。 `{
  "mcp_servers": {
    "runapi": {
      "url": "https://runapi.ai/mcp",
      "transport": "streamable_http",
      "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" }
    }
  }
}
`
2. **提示工作台 agent** - 以自然語言向 WorkBuddy 要求 Runway 影片 — 描述場景、選擇 5 或 10 秒，以及選擇 720p 或 1080p。agent 會將您的請求對應至 runapi MCP server 公開的 Runway 工具；若附加參考圖片，也會包含 first_frame_image_url。 `Generate a 10-second 1080p video with Runway Gen-4:
a drone shot rising over a misty mountain lake at sunrise.
`
3. **取得影片 URL** - Runway 任務為非同步。WorkBuddy 會透過 MCP server 輪詢，直到 status 為 completed，接著將輸出影片 URL 發佈到您的對話中。若要延長片段，請要求 agent 使用 source_task_id 呼叫 extend_video。 `{
  "task_id": "tsk_abc123",
  "status": "completed",
  "output": { "video_url": "https://media.runapi.ai/videos/tsk_abc123.mp4" }
}
`

## Runway 工具參數

| 參數 | 類型 | 說明 |
| --- | --- | --- |
| `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。 |

## WorkBuddy 上的 Runway 是什麼？

Runway Gen-4 以快速、乾淨且具電影感的輸出聞名，擁有流暢動態和高度提示遵循性。它可根據文字提示或參考圖片生成 5 或 10 秒、720p 或 1080p 的片段，並透過場景一致性讓角色和環境在單一鏡頭內保持穩定。WorkBuddy 透過 runapi MCP server 存取它；這也是同一個以 RUNAPI_API_KEY 為 workbench 中所有其他模型提供支援的 server。

## Runway 使用情境

- **創作者的片頭與 B-roll 素材** - 請 WorkBuddy 為 YouTube、Instagram 或 TikTok 內容製作精緻的片頭序列和 B-roll 素材。Runway 的電影感構圖可根據自然語言簡述生成播出級片段。
- **微型廣告與短影音** - 從 workbench 製作 5 秒或 10 秒的廣告片段與宣傳 Reels。附加產品圖片作為第一影格，Runway 便會以鏡頭運動和自然光線為其製作動畫。
- **影視前期視覺化** - 為敘事內容生成具有一致角色的概念短片。在投入正式製作前，使用參考圖片鎖定角色外觀，跨多個鏡頭保持一致性。

## Runway + WorkBuddy 問題

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

可以。使用您的 RUNAPI_API_KEY 將 RunAPI 新增為 MCP server，Runway 工具便會與其他所有 RunAPI 模型一同出現。請 workbench agent 根據提示、時長（5 或 10 秒）及解析度（720p 或 1080p）製作影片，它會為您處理呼叫。

### Runway Gen-4 與 Runway Aleph 有何差異？

Runway Gen-4（model: runway）處理 text_to_video 和 extend_video — 從文字或圖片建立新片段。Runway Aleph（model: runway-aleph）處理 edit_video — 使用文字提示重新風格化現有影片。兩者皆由同一個 runapi MCP server 公開，因此 WorkBuddy 可依每次請求在兩者間切換。

### RunAPI 上的 Runway 如何計費？

Runway 根據 duration_seconds 和 output_resolution 採用矩陣計費。5 秒 720p 片段的費用低於 10 秒 1080p 片段。請查看 RunAPI 定價頁面以取得目前費率。按用量付費，無需訂閱。

### WorkBuddy 會等待影片完成，還是我必須自行輪詢？

由 workbench agent 處理。Runway 任務為非同步 — 工具會回傳 task_id，WorkBuddy 透過 MCP server 輪詢任務，直到 status 為 completed，然後將影片 URL 發佈到您的對話中。您無需自行管理輪詢迴圈。

### 生成後可以延長 Runway 影片嗎？

可以。請 WorkBuddy 延長片段 — agent 會使用原始生成的 source_task_id 與您的新提示呼叫 extend_video。延長內容會附加至現有片段，並依 output_resolution 按片段計費。


- [WorkBuddy 設定指南 →](https://runapi.ai/zh-TW/workbuddy.md) - 尚未連線嗎？請先參閱 WorkBuddy 的 RunAPI MCP 設定指南。
- [Runway on RunAPI →](https://runapi.ai/zh-TW/models/runway.md) - 查看 Runway Gen-4 與 Aleph 變體、定價及 API 文件。

## 立即在 WorkBuddy 中試用 Runway。

取得免費 RunAPI key，將 MCP server 新增至 WorkBuddy，無須離開工作台即可使用 Runway Gen-4 以 720p 或 1080p 生成電影感影片。

[瀏覽模型 →](https://runapi.ai/zh-TW/models.md)

---

## More from RunAPI

- [Home](https://runapi.ai/zh-TW/.md)
### 產品
- [模型目錄](https://runapi.ai/zh-TW/models.md)
- [價格](https://runapi.ai/zh-TW/pricing.md)
- [提供商](https://runapi.ai/zh-TW/models#all-models)
### 開發者
- [文件](https://runapi.ai/zh-TW/docs/guides)
- [SDK](https://runapi.ai/zh-TW/sdk.md)
- [CLI](https://runapi.ai/zh-TW/cli.md)
- [MCP Server](https://runapi.ai/zh-TW/mcp.md)
- [x402](https://runapi.ai/zh-TW/x402.md)
### 指南
- [Claude Code 與 Cursor](https://runapi.ai/zh-TW/claude-code-vs-cursor.md)
- [Cursor API 設定](https://runapi.ai/zh-TW/cursor-api-setup.md)
- [RunAPI 與 OpenRouter](https://runapi.ai/zh-TW/openrouter-alternative.md)
### 公司
- [企業版](https://runapi.ai/zh-TW/contact.md)
- [聯絡我們](https://runapi.ai/zh-TW/contact.md)
### 法律
- [服務條款](https://runapi.ai/zh-TW/terms.md)
- [隱私權](https://runapi.ai/zh-TW/privacy.md)
- [Site index for agents](https://runapi.ai/llms.txt)

Contact: contact@runapi.ai

## Structured data

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-TW",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/zh-TW/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-TW",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/zh-TWicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "SoftwareApplication",
    "name": "適用於 WorkBuddy 的 RunAPI Runway",
    "applicationCategory": "DeveloperApplication",
    "description": "透過 RunAPI MCP server 在 WorkBuddy 中使用 Runway Gen-4 生成影片。text-to-video、5 秒或 10 秒片段、720p/1080p、一組 API key。",
    "url": "https://runapi.ai/zh-TW/workbuddy-runway"
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "我可以在 WorkBuddy 中使用 Runway 影片生成嗎？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "可以。使用您的 RUNAPI_API_KEY 將 RunAPI 新增為 MCP server，Runway 工具便會與其他所有 RunAPI 模型一同出現。請 workbench agent 根據提示、時長（5 或 10 秒）及解析度（720p 或 1080p）製作影片，它會為您處理呼叫。"
        }
      },
      {
        "@type": "Question",
        "name": "Runway Gen-4 與 Runway Aleph 有何差異？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Runway Gen-4（model: runway）處理 text_to_video 和 extend_video — 從文字或圖片建立新片段。Runway Aleph（model: runway-aleph）處理 edit_video — 使用文字提示重新風格化現有影片。兩者皆由同一個 runapi MCP server 公開，因此 WorkBuddy 可依每次請求在兩者間切換。"
        }
      },
      {
        "@type": "Question",
        "name": "RunAPI 上的 Runway 如何計費？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Runway 根據 duration_seconds 和 output_resolution 採用矩陣計費。5 秒 720p 片段的費用低於 10 秒 1080p 片段。請查看 RunAPI 定價頁面以取得目前費率。按用量付費，無需訂閱。"
        }
      },
      {
        "@type": "Question",
        "name": "WorkBuddy 會等待影片完成，還是我必須自行輪詢？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "由 workbench agent 處理。Runway 任務為非同步 — 工具會回傳 task_id，WorkBuddy 透過 MCP server 輪詢任務，直到 status 為 completed，然後將影片 URL 發佈到您的對話中。您無需自行管理輪詢迴圈。"
        }
      },
      {
        "@type": "Question",
        "name": "生成後可以延長 Runway 影片嗎？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "可以。請 WorkBuddy 延長片段 — agent 會使用原始生成的 source_task_id 與您的新提示呼叫 extend_video。延長內容會附加至現有片段，並依 output_resolution 按片段計費。"
        }
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "HowTo",
    "name": "如何透過 RunAPI 在 WorkBuddy 中使用 Runway",
    "description": "在 WorkBuddy 中將 RunAPI 新增為 MCP server，提示 workbench agent 生成可控制時長和解析度的 Runway Gen-4 影片，即可收到完成的影片 URL。",
    "step": [
      {
        "@type": "HowToStep",
        "position": 1,
        "name": "新增 RunAPI MCP server",
        "text": "在 WorkBuddy 中註冊名為 runapi、指向 https://runapi.ai/mcp 的 MCP server，並使用 Authorization header 從 RUNAPI_API_KEY 讀取您的 key。如果您已將 RunAPI 連接至 WorkBuddy，同一個 server 已提供 Runway 工具 — 無需額外設定。",
        "url": "https://runapi.ai/zh-TW/workbuddy-runway#how-step-1"
      },
      {
        "@type": "HowToStep",
        "position": 2,
        "name": "提示工作台 agent",
        "text": "以自然語言向 WorkBuddy 要求 Runway 影片 — 描述場景、選擇 5 或 10 秒，以及選擇 720p 或 1080p。agent 會將您的請求對應至 runapi MCP server 公開的 Runway 工具；若附加參考圖片，也會包含 first_frame_image_url。",
        "url": "https://runapi.ai/zh-TW/workbuddy-runway#how-step-2"
      },
      {
        "@type": "HowToStep",
        "position": 3,
        "name": "取得影片 URL",
        "text": "Runway 任務為非同步。WorkBuddy 會透過 MCP server 輪詢，直到 status 為 completed，接著將輸出影片 URL 發佈到您的對話中。若要延長片段，請要求 agent 使用 source_task_id 呼叫 extend_video。",
        "url": "https://runapi.ai/zh-TW/workbuddy-runway#how-step-3"
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "首頁",
        "item": "https://runapi.ai/zh-TW"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "適用於 WorkBuddy 的 RunAPI Runway",
        "item": "https://runapi.ai/zh-TW/workbuddy-runway"
      }
    ]
  }
]
```
