--- title: RunAPI를 통해 WorkBuddy에서 Luma 사용하기 — 영상 MCP 가이드 | RunAPI description: RunAPI MCP 서버를 통해 WorkBuddy에서 Luma Ray 3.2로 영상을 수정하세요. 공간 일관성을 갖춘 프롬프트 기반 변환, API 키 1개. url: https://runapi.ai/ko/workbuddy-luma.md canonical: https://runapi.ai/ko/workbuddy-luma locale: ko site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-luma zh-CN: https://runapi.ai/zh-CN/workbuddy-luma es: https://runapi.ai/es/workbuddy-luma ja: https://runapi.ai/ja/workbuddy-luma de: https://runapi.ai/de/workbuddy-luma fr: https://runapi.ai/fr/workbuddy-luma pt-BR: https://runapi.ai/pt-BR/workbuddy-luma ko: https://runapi.ai/ko/workbuddy-luma it: https://runapi.ai/it/workbuddy-luma nl: https://runapi.ai/nl/workbuddy-luma pl: https://runapi.ai/pl/workbuddy-luma tr: https://runapi.ai/tr/workbuddy-luma zh-TW: https://runapi.ai/zh-TW/workbuddy-luma zh-HK: https://runapi.ai/zh-HK/workbuddy-luma ar: https://runapi.ai/ar/workbuddy-luma x-default: https://runapi.ai/workbuddy-luma model: luma --- > HTML version: https://runapi.ai/ko/workbuddy-luma > Site index for agents: https://runapi.ai/llms.txt # WorkBuddy에서 Luma를 사용하세요. Luma Ray 3.2는 공간 일관성과 3D 장면 구조를 보존하는 프롬프트 기반 변환으로 기존 영상을 수정합니다. WorkBuddy는 MCP를 기본으로 지원합니다 — RunAPI를 MCP 서버로 한 번만 추가하면, 워크벤치 에이전트에게 소스 영상 URL을 전달하고 변환을 설명할 수 있습니다. 에이전트가 Luma 도구를 호출하고 비동기 작업을 대기한 후, 대기 조명과 물리적으로 일관된 카메라 움직임이 적용된 재렌더링 영상을 반환합니다. - [API Key 받기](https://runapi.ai/ko/login) - [문서 읽기](https://runapi.ai/ko/docs/guides) MCP 서버 1개 · RunAPI 키 1개 · 비동기 작업 처리 ### 프롬프트 ```text Modify a video with Luma Ray 3.2 through the runapi MCP server. Requirements: - Use the runapi MCP server's video modification tool. - Set model to "luma-modify-video". - Source video: https://example.com/park-walk.mp4 - Transformation: "Transform the scene into a foggy autumn morning with golden light filtering through trees". - The task is async — wait for it to complete and give me the modified 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": "luma-modify-video", "output": { "video_url": "https://media.runapi.ai/videos/tsk_abc123.mp4" } } ``` ## 세 단계로 WorkBuddy에서 Luma 사용하기 1. **RunAPI MCP 서버 추가** - RUNAPI_API_KEY 환경 변수에서 키를 읽는 Authorization 헤더를 사용하여, https://runapi.ai/mcp를 가리키는 runapi라는 이름의 MCP 서버로 RunAPI를 등록하세요. 이미 WorkBuddy에 RunAPI를 연결했다면 동일한 서버에서 Luma 도구가 노출되므로 추가 설정이 필요하지 않습니다. `{ "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ` 2. **워크벤치 에이전트에 프롬프트 입력** - WorkBuddy에게 소스 영상 URL을 제공하고 일반 언어로 변환을 설명하세요 — 분위기, 조명, 스타일 또는 장면 편집. 에이전트가 요청을 모델이 luma-modify-video로 설정된 Luma modify_video 도구에 매핑하며, Luma는 변경 사항을 적용하면서 원본 장면의 형태를 보존합니다. `Restyle https://example.com/park-walk.mp4 with Luma: a foggy autumn morning with golden light filtering through trees. ` 3. **수정된 영상 수신** - Luma 작업은 비동기입니다. WorkBuddy가 MCP 서버를 통해 상태가 completed가 될 때까지 폴링한 후, 재렌더링된 영상 URL을 대화에 게시합니다. 일반적인 처리 시간은 복잡도에 따라 30~120초입니다. `{ "task_id": "tsk_abc123", "status": "completed", "output": { "video_url": "https://media.runapi.ai/videos/tsk_abc123.mp4" } } ` ## Luma modify_video 도구 파라미터 | 파라미터 | 유형 | 설명 | | --- | --- | --- | | `model` | `string` | 필수. luma-modify-video를 사용하세요. | | `prompt` | `string` | 필수. 원하는 영상 변환에 대한 텍스트 설명 — 스타일 변경, 조명, 분위기 또는 장면 편집. | | `source_video_url` | `string` | 필수. 수정할 원본 영상의 URL. 공개적으로 접근 가능한 MP4 또는 MOV 파일이어야 합니다. | | `watermark` | `boolean` | 선택. 출력 영상에 워터마크를 추가할지 여부. | | `callback_url` | `string` | 선택 사항. 작업 완료 시 POST 요청을 받는 webhook URL. | | `task_id` | `string` | 도구가 반환합니다. WorkBuddy가 수정된 영상이 준비될 때까지 비동기 작업을 폴링하는 데 사용합니다. | ## WorkBuddy의 Luma란? Luma Ray 3.2(Dream Machine)는 사용자들이 영화적이고 빠른 반복 작업에 적합하다고 평가하는 몽환적 화질로 기존 영상을 수정하는 데 특화되어 있습니다. 처음부터 생성하는 대신, 소스 영상을 프롬프트 기반 변환 — 분위기 변화, 스타일 전환, 환경 변경 — 으로 재렌더링하면서 원본의 공간 레이아웃과 카메라 움직임을 유지합니다. WorkBuddy는 runapi MCP 서버를 통해 이를 활용하며, 워크벤치의 다른 모든 모델을 구동하는 것과 동일한 서버 및 RUNAPI_API_KEY를 사용합니다. ## Luma 활용 사례 - **무드 영상 및 뮤직비디오 감성** - WorkBuddy에게 Luma의 몽환적 화질로 원본 영상을 스타일화된 분위기 있는 영상으로 변환하도록 요청하세요. 뮤직 비디오 콘셉트나 예술 프로젝트를 위해 원본 동작을 유지하면서 조명, 분위기, 색 팔레트를 변경할 수 있습니다. - **광고 방향에 대한 빠른 시각적 가설 검토** - 단일 워크벤치 대화에서 기존 제품 영상을 영화적, 미니멀, 누아르, 계절감 등 여러 시각적 방향으로 리스타일링하여 전면 재촬영 전에 어떤 스타일이 효과적인지 테스트해 보세요. - **멀티툴 파이프라인을 위한 기본 영상 소스** - Luma를 사용해 생성하거나 촬영한 영상을 리스타일링한 후, WorkBuddy가 동일한 세션에서 결과물을 다른 RunAPI 도구로 전달하도록 하세요. Luma의 빠른 처리 속도는 더 큰 영상 파이프라인에서 스타일링 단계로 활용하기에 적합합니다. ## Luma + WorkBuddy 질문 ### WorkBuddy에서 Luma로 어떤 변환이 가능한가요? Luma modify_video는 프롬프트 기반 변환으로 기존 영상을 재렌더링합니다 — 분위기 변화(안개, 비, 황금빛), 스타일 전환(영화적, 애니메, 누아르), 조명 전면 개편, 환경 변형. 원본 카메라 움직임과 공간 레이아웃을 보존하며, WorkBuddy가 일반 언어 프롬프트로 모두 구동합니다. ### Luma는 RunAPI의 다른 영상 모델과 어떻게 다른가요? Luma는 처음부터 생성하는 것이 아닌 기존 영상 수정에 특화되어 있습니다. Ray 3.2 모델은 변환 중 3D 공간 일관성을 유지하므로 객체의 깊이 관계와 카메라 움직임의 물리적 일관성이 보존됩니다. Kling이나 Hailuo 같은 모델은 텍스트나 이미지에서 새 영상을 생성하며, 모두 동일한 runapi MCP 서버에서 이용할 수 있습니다. ### WorkBuddy가 결과를 기다리나요, 아니면 직접 폴링해야 하나요? 워크벤치 에이전트가 처리합니다. Luma 작업은 비동기로, 도구가 task_id를 반환하면 WorkBuddy가 MCP 서버를 통해 상태가 completed가 될 때까지 폴링한 후 수정된 영상 URL을 대화에 게시합니다. 일반적인 처리 시간은 30~120초입니다. ### RunAPI에서 Luma 영상 수정 비용은 얼마인가요? Luma는 작업당 고정 요금제를 사용합니다 — 각 modify_video 호출은 영상 길이에 관계없이 고정 금액이 청구됩니다. 현재 요금은 RunAPI 가격 페이지를 확인하세요. 생성 실패 시 요금이 청구되지 않습니다. ### 단일 WorkBuddy 세션에서 Luma와 다른 RunAPI 영상 모델을 연계할 수 있나요? 네. WorkBuddy에게 Kling이나 Hailuo로 영상을 생성하도록 요청한 후, 출력 URL을 Luma modify_video의 source_video_url로 전달하여 후처리할 수 있습니다 — 모두 동일한 runapi MCP 서버와 RUNAPI_API_KEY를 사용하여 단일 대화에서 가능합니다. - [WorkBuddy 설정 가이드 →](https://runapi.ai/ko/workbuddy.md) - 아직 연결하지 않으셨나요? WorkBuddy용 RunAPI MCP 설정 가이드를 참조하세요. - [RunAPI에서 Luma 보기 →](https://runapi.ai/ko/models/luma.md) - Luma 변형, 가격 및 API 문서를 확인하세요. ## 지금 WorkBuddy에서 Luma를 사용해 보세요. 무료 RunAPI 키를 발급받고, WorkBuddy에 MCP 서버를 추가한 후, 워크벤치를 벗어나지 않고 Luma Ray 3.2의 공간 인식 변환으로 영상 수정을 시작하세요. [모델 보기 →](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 Luma", "applicationCategory": "DeveloperApplication", "description": "RunAPI MCP 서버를 통해 WorkBuddy에서 Luma Ray 3.2로 영상을 수정하세요. 공간 일관성을 갖춘 프롬프트 기반 변환, API 키 1개.", "url": "https://runapi.ai/ko/workbuddy-luma" }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "WorkBuddy에서 Luma로 어떤 변환이 가능한가요?", "acceptedAnswer": { "@type": "Answer", "text": "Luma modify_video는 프롬프트 기반 변환으로 기존 영상을 재렌더링합니다 — 분위기 변화(안개, 비, 황금빛), 스타일 전환(영화적, 애니메, 누아르), 조명 전면 개편, 환경 변형. 원본 카메라 움직임과 공간 레이아웃을 보존하며, WorkBuddy가 일반 언어 프롬프트로 모두 구동합니다." } }, { "@type": "Question", "name": "Luma는 RunAPI의 다른 영상 모델과 어떻게 다른가요?", "acceptedAnswer": { "@type": "Answer", "text": "Luma는 처음부터 생성하는 것이 아닌 기존 영상 수정에 특화되어 있습니다. Ray 3.2 모델은 변환 중 3D 공간 일관성을 유지하므로 객체의 깊이 관계와 카메라 움직임의 물리적 일관성이 보존됩니다. Kling이나 Hailuo 같은 모델은 텍스트나 이미지에서 새 영상을 생성하며, 모두 동일한 runapi MCP 서버에서 이용할 수 있습니다." } }, { "@type": "Question", "name": "WorkBuddy가 결과를 기다리나요, 아니면 직접 폴링해야 하나요?", "acceptedAnswer": { "@type": "Answer", "text": "워크벤치 에이전트가 처리합니다. Luma 작업은 비동기로, 도구가 task_id를 반환하면 WorkBuddy가 MCP 서버를 통해 상태가 completed가 될 때까지 폴링한 후 수정된 영상 URL을 대화에 게시합니다. 일반적인 처리 시간은 30~120초입니다." } }, { "@type": "Question", "name": "RunAPI에서 Luma 영상 수정 비용은 얼마인가요?", "acceptedAnswer": { "@type": "Answer", "text": "Luma는 작업당 고정 요금제를 사용합니다 — 각 modify_video 호출은 영상 길이에 관계없이 고정 금액이 청구됩니다. 현재 요금은 RunAPI 가격 페이지를 확인하세요. 생성 실패 시 요금이 청구되지 않습니다." } }, { "@type": "Question", "name": "단일 WorkBuddy 세션에서 Luma와 다른 RunAPI 영상 모델을 연계할 수 있나요?", "acceptedAnswer": { "@type": "Answer", "text": "네. WorkBuddy에게 Kling이나 Hailuo로 영상을 생성하도록 요청한 후, 출력 URL을 Luma modify_video의 source_video_url로 전달하여 후처리할 수 있습니다 — 모두 동일한 runapi MCP 서버와 RUNAPI_API_KEY를 사용하여 단일 대화에서 가능합니다." } } ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "HowTo", "name": "RunAPI를 통해 WorkBuddy에서 Luma를 사용하는 방법", "description": "RunAPI를 WorkBuddy의 MCP 서버로 추가하고, 워크벤치 에이전트에게 소스 영상과 변환 프롬프트를 전달하면 재렌더링된 Luma Ray 3.2 결과물을 받을 수 있습니다.", "step": [ { "@type": "HowToStep", "position": 1, "name": "RunAPI MCP 서버 추가", "text": "RUNAPI_API_KEY 환경 변수에서 키를 읽는 Authorization 헤더를 사용하여, https://runapi.ai/mcp를 가리키는 runapi라는 이름의 MCP 서버로 RunAPI를 등록하세요. 이미 WorkBuddy에 RunAPI를 연결했다면 동일한 서버에서 Luma 도구가 노출되므로 추가 설정이 필요하지 않습니다.", "url": "https://runapi.ai/ko/workbuddy-luma#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "워크벤치 에이전트에 프롬프트 입력", "text": "WorkBuddy에게 소스 영상 URL을 제공하고 일반 언어로 변환을 설명하세요 — 분위기, 조명, 스타일 또는 장면 편집. 에이전트가 요청을 모델이 luma-modify-video로 설정된 Luma modify_video 도구에 매핑하며, Luma는 변경 사항을 적용하면서 원본 장면의 형태를 보존합니다.", "url": "https://runapi.ai/ko/workbuddy-luma#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "수정된 영상 수신", "text": "Luma 작업은 비동기입니다. WorkBuddy가 MCP 서버를 통해 상태가 completed가 될 때까지 폴링한 후, 재렌더링된 영상 URL을 대화에 게시합니다. 일반적인 처리 시간은 복잡도에 따라 30~120초입니다.", "url": "https://runapi.ai/ko/workbuddy-luma#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 Luma", "item": "https://runapi.ai/ko/workbuddy-luma" } ] } ] ```