--- title: RunAPI를 통해 WorkBuddy에서 Runway 사용하기 — 영상 MCP 가이드 | RunAPI description: RunAPI MCP 서버를 통해 WorkBuddy에서 Runway Gen-4로 영상을 생성하세요. 텍스트-영상, 5초 또는 10초 클립, 720p/1080p, API 키 하나로 시작하세요. url: https://runapi.ai/ko/workbuddy-runway.md canonical: https://runapi.ai/ko/workbuddy-runway locale: ko 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/ko/workbuddy-runway > Site index for agents: https://runapi.ai/llms.txt # WorkBuddy에서 Runway를 사용하세요. Runway Gen-4는 텍스트 프롬프트 또는 첫 프레임 이미지로 720p 또는 1080p의 5초 또는 10초 영상을 생성합니다. WorkBuddy는 MCP를 기본으로 지원합니다 — RunAPI를 MCP 서버로 한 번만 추가하면, 워크벤치 에이전트에게 영상을 요청할 수 있습니다. 에이전트가 Runway 도구를 호출하고 비동기 작업이 완료될 때까지 대기한 후, 완성된 영상 URL을 채팅에 반환합니다. 같은 방식으로 Runway Aleph를 사용해 클립을 연장하거나 영상을 리스타일링하세요. - [API Key 받기](https://runapi.ai/ko/login) - [문서 읽기](https://runapi.ai/ko/docs/guides) MCP 서버 1개 · RunAPI 키 1개 · 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 서버 추가** - RUNAPI_API_KEY 환경 변수에서 키를 읽는 Authorization 헤더를 사용하여, https://runapi.ai/mcp를 가리키는 runapi라는 이름의 MCP 서버로 RunAPI를 등록하세요. 이미 WorkBuddy에 RunAPI를 연결했다면 동일한 서버에서 Runway 도구가 노출되므로 추가 설정이 필요하지 않습니다. `{ "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ` 2. **워크벤치 에이전트에 프롬프트 입력** - WorkBuddy에게 일반 언어로 Runway 영상을 요청하세요 — 장면을 묘사하고, 5초 또는 10초를 선택하고, 720p 또는 1080p를 고르세요. 에이전트가 요청을 runapi MCP 서버에서 노출된 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 서버를 통해 상태가 completed가 될 때까지 폴링한 후, 출력 영상 URL을 대화에 게시합니다. 클립을 연장하려면 에이전트에게 원본 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는 부드러운 동작과 강력한 프롬프트 준수로 빠르고 깔끔한 영화적 출력으로 유명합니다. 텍스트 프롬프트 또는 참조 이미지로 720p 또는 1080p의 5초 또는 10초 클립을 생성하며, 샷 내에서 캐릭터와 환경을 안정적으로 유지하는 세계 일관성을 갖추고 있습니다. WorkBuddy는 runapi MCP 서버를 통해 이를 활용하며, 워크벤치의 다른 모든 모델을 구동하는 것과 동일한 서버 및 RUNAPI_API_KEY를 사용합니다. ## Runway 활용 사례 - **크리에이터용 인트로 및 B-롤** - WorkBuddy에게 YouTube, Instagram 또는 TikTok 콘텐츠용 세련된 인트로 시퀀스와 B-롤 영상을 요청하세요. Runway의 영화적 프레이밍이 일반 언어 브리프에서 방송 품질의 클립을 만들어 냅니다. - **마이크로 광고 및 짧은 릴스** - 워크벤치에서 5초 또는 10초 광고 클립과 홍보 릴을 제작하세요. 제품 이미지를 첫 프레임으로 첨부하면 Runway가 카메라 움직임과 자연스러운 조명으로 애니메이션을 만들어 줍니다. - **영화 제작 사전 시각화** - 참조 이미지를 사용하여 여러 샷에 걸쳐 캐릭터 외모를 고정하고, 본격 제작 전에 일관된 캐릭터가 등장하는 내러티브 콘텐츠 컨셉 클립을 생성합니다. ## Runway + WorkBuddy 질문 ### WorkBuddy에서 Runway 영상 생성을 사용할 수 있나요? 네. RUNAPI_API_KEY로 RunAPI를 MCP 서버로 추가하면 Runway 도구가 다른 모든 RunAPI 모델과 함께 표시됩니다. 워크벤치 에이전트에게 프롬프트, 재생 시간(5초 또는 10초), 해상도(720p 또는 1080p)를 포함하여 영상을 요청하면 에이전트가 호출을 처리합니다. ### Runway Gen-4와 Runway Aleph의 차이점은 무엇인가요? Runway Gen-4(모델: runway)는 텍스트나 이미지에서 새 클립을 만드는 text_to_video와 extend_video를 처리합니다. Runway Aleph(모델: runway-aleph)는 텍스트 프롬프트로 기존 영상을 리스타일링하는 edit_video를 처리합니다. 둘 다 동일한 runapi MCP 서버에서 노출되므로 WorkBuddy가 요청에 따라 전환할 수 있습니다. ### RunAPI에서 Runway 가격은 어떻게 책정되나요? Runway는 duration_seconds와 output_resolution을 기반으로 매트릭스 과금 방식을 사용합니다. 5초 720p 클립은 10초 1080p 클립보다 비용이 적게 듭니다. 현재 요금은 RunAPI 가격 페이지에서 확인하세요. 사용한 만큼만 지불하며, 구독이 필요 없습니다. ### WorkBuddy가 영상을 기다리나요, 아니면 제가 직접 폴링해야 하나요? 워크벤치 에이전트가 처리합니다. Runway 작업은 비동기로, 도구가 task_id를 반환하면 WorkBuddy가 MCP 서버를 통해 상태가 completed가 될 때까지 폴링한 후 영상 URL을 대화에 게시합니다. 폴링 루프를 직접 관리할 필요가 없습니다. ### 생성 후 Runway 영상을 연장할 수 있나요? 네. WorkBuddy에게 클립 연장을 요청하면 에이전트가 원본 생성의 source_task_id와 새 프롬프트로 extend_video를 호출합니다. 연장은 기존 클립에 이어붙여지며, output_resolution을 기준으로 클립당 과금됩니다. - [WorkBuddy 설정 가이드 →](https://runapi.ai/ko/workbuddy.md) - 아직 연결하지 않으셨나요? WorkBuddy용 RunAPI MCP 설정 가이드를 참조하세요. - [RunAPI에서 Runway 보기 →](https://runapi.ai/ko/models/runway.md) - Runway Gen-4 및 Aleph 변형, 가격 및 API 문서를 확인하세요. ## 지금 WorkBuddy에서 Runway를 사용해 보세요. 무료 RunAPI 키를 발급받고, WorkBuddy에 MCP 서버를 추가한 후, 워크벤치를 벗어나지 않고 Runway Gen-4로 720p 또는 1080p의 영화적 영상을 생성하세요. [모델 보기 →](https://runapi.ai/ko/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/ko/.md) ### 제품 - [모델 카탈로그](https://runapi.ai/ko/models.md) - [요금](https://runapi.ai/ko/pricing.md) - [제공사](https://runapi.ai/ko/models#all-models) ### 개발자 - [문서](https://runapi.ai/ko/docs/guides) - [SDK](https://runapi.ai/ko/sdk.md) - [CLI](https://runapi.ai/ko/cli.md) - [MCP Server](https://runapi.ai/ko/mcp.md) - [x402](https://runapi.ai/ko/x402.md) ### 가이드 - [Claude Code와 Cursor](https://runapi.ai/ko/claude-code-vs-cursor.md) - [Cursor API 설정](https://runapi.ai/ko/cursor-api-setup.md) - [RunAPI와 OpenRouter 비교](https://runapi.ai/ko/openrouter-alternative.md) ### 회사 - [엔터프라이즈](https://runapi.ai/ko/contact.md) - [문의](https://runapi.ai/ko/contact.md) ### 법적 고지 - [약관](https://runapi.ai/ko/terms.md) - [개인정보](https://runapi.ai/ko/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "ko", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/ko", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/ko/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/ko", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/koicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "SoftwareApplication", "name": "WorkBuddy용 RunAPI Runway", "applicationCategory": "DeveloperApplication", "description": "RunAPI MCP 서버를 통해 WorkBuddy에서 Runway Gen-4로 영상을 생성하세요. 텍스트-영상, 5초 또는 10초 클립, 720p/1080p, API 키 하나로 시작하세요.", "url": "https://runapi.ai/ko/workbuddy-runway" }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "WorkBuddy에서 Runway 영상 생성을 사용할 수 있나요?", "acceptedAnswer": { "@type": "Answer", "text": "네. RUNAPI_API_KEY로 RunAPI를 MCP 서버로 추가하면 Runway 도구가 다른 모든 RunAPI 모델과 함께 표시됩니다. 워크벤치 에이전트에게 프롬프트, 재생 시간(5초 또는 10초), 해상도(720p 또는 1080p)를 포함하여 영상을 요청하면 에이전트가 호출을 처리합니다." } }, { "@type": "Question", "name": "Runway Gen-4와 Runway Aleph의 차이점은 무엇인가요?", "acceptedAnswer": { "@type": "Answer", "text": "Runway Gen-4(모델: runway)는 텍스트나 이미지에서 새 클립을 만드는 text_to_video와 extend_video를 처리합니다. Runway Aleph(모델: runway-aleph)는 텍스트 프롬프트로 기존 영상을 리스타일링하는 edit_video를 처리합니다. 둘 다 동일한 runapi MCP 서버에서 노출되므로 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": "워크벤치 에이전트가 처리합니다. Runway 작업은 비동기로, 도구가 task_id를 반환하면 WorkBuddy가 MCP 서버를 통해 상태가 completed가 될 때까지 폴링한 후 영상 URL을 대화에 게시합니다. 폴링 루프를 직접 관리할 필요가 없습니다." } }, { "@type": "Question", "name": "생성 후 Runway 영상을 연장할 수 있나요?", "acceptedAnswer": { "@type": "Answer", "text": "네. WorkBuddy에게 클립 연장을 요청하면 에이전트가 원본 생성의 source_task_id와 새 프롬프트로 extend_video를 호출합니다. 연장은 기존 클립에 이어붙여지며, output_resolution을 기준으로 클립당 과금됩니다." } } ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "HowTo", "name": "RunAPI를 통해 WorkBuddy에서 Runway를 사용하는 방법", "description": "RunAPI를 WorkBuddy의 MCP 서버로 추가하고, 워크벤치 에이전트에게 재생 시간과 해상도를 지정하여 Runway Gen-4 영상 생성을 요청하면 완성된 영상 URL을 받을 수 있습니다.", "step": [ { "@type": "HowToStep", "position": 1, "name": "RunAPI MCP 서버 추가", "text": "RUNAPI_API_KEY 환경 변수에서 키를 읽는 Authorization 헤더를 사용하여, https://runapi.ai/mcp를 가리키는 runapi라는 이름의 MCP 서버로 RunAPI를 등록하세요. 이미 WorkBuddy에 RunAPI를 연결했다면 동일한 서버에서 Runway 도구가 노출되므로 추가 설정이 필요하지 않습니다.", "url": "https://runapi.ai/ko/workbuddy-runway#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "워크벤치 에이전트에 프롬프트 입력", "text": "WorkBuddy에게 일반 언어로 Runway 영상을 요청하세요 — 장면을 묘사하고, 5초 또는 10초를 선택하고, 720p 또는 1080p를 고르세요. 에이전트가 요청을 runapi MCP 서버에서 노출된 Runway 도구에 매핑하며, 참조 이미지를 첨부하면 first_frame_image_url도 포함됩니다.", "url": "https://runapi.ai/ko/workbuddy-runway#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "영상 URL 받기", "text": "Runway 작업은 비동기입니다. WorkBuddy가 MCP 서버를 통해 상태가 completed가 될 때까지 폴링한 후, 출력 영상 URL을 대화에 게시합니다. 클립을 연장하려면 에이전트에게 원본 source_task_id로 extend_video를 호출하도록 요청하세요.", "url": "https://runapi.ai/ko/workbuddy-runway#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "홈", "item": "https://runapi.ai/ko" }, { "@type": "ListItem", "position": 2, "name": "WorkBuddy용 RunAPI Runway", "item": "https://runapi.ai/ko/workbuddy-runway" } ] } ] ```