--- title: RunAPI를 통해 WorkBuddy에서 Hailuo 사용하기 — 영상 MCP 가이드 | RunAPI description: RunAPI MCP 서버를 통해 WorkBuddy에서 MiniMax Hailuo로 영상을 생성하세요. 텍스트 또는 이미지로 영상 생성, 6가지 변형, 네이티브 1080p, API 키 하나로 시작하세요. url: https://runapi.ai/ko/workbuddy-hailuo.md canonical: https://runapi.ai/ko/workbuddy-hailuo locale: ko site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-hailuo zh-CN: https://runapi.ai/zh-CN/workbuddy-hailuo es: https://runapi.ai/es/workbuddy-hailuo ja: https://runapi.ai/ja/workbuddy-hailuo de: https://runapi.ai/de/workbuddy-hailuo fr: https://runapi.ai/fr/workbuddy-hailuo pt-BR: https://runapi.ai/pt-BR/workbuddy-hailuo ko: https://runapi.ai/ko/workbuddy-hailuo it: https://runapi.ai/it/workbuddy-hailuo nl: https://runapi.ai/nl/workbuddy-hailuo pl: https://runapi.ai/pl/workbuddy-hailuo tr: https://runapi.ai/tr/workbuddy-hailuo zh-TW: https://runapi.ai/zh-TW/workbuddy-hailuo zh-HK: https://runapi.ai/zh-HK/workbuddy-hailuo ar: https://runapi.ai/ar/workbuddy-hailuo x-default: https://runapi.ai/workbuddy-hailuo model: hailuo --- > HTML version: https://runapi.ai/ko/workbuddy-hailuo > Site index for agents: https://runapi.ai/llms.txt # WorkBuddy에서 Hailuo를 사용하세요. Hailuo는 MiniMax의 영상 생성 모델로 6가지 변형 — Hailuo 02와 2.3, 각각 텍스트-영상 및 이미지-영상 endpoint를 pro/standard 티어로 제공하며 — 정확한 물리 시뮬레이션을 갖춘 네이티브 1080p 영상을 생성합니다. WorkBuddy는 MCP를 기본 지원합니다 — RunAPI를 MCP 서버로 한 번만 추가하면 워크벤치 에이전트에 영상 요청 시 Hailuo 도구를 호출해 완성된 URL을 반환합니다. - [API Key 받기](https://runapi.ai/ko/login) - [문서 읽기](https://runapi.ai/ko/docs/guides) MCP 서버 하나 · 텍스트-영상 + 이미지-영상 · 네이티브 1080p ### 프롬프트 ```text Generate a video with MiniMax Hailuo 02 Pro through the runapi MCP server. Requirements: - Use the runapi MCP server's video generation tool. - Set model to "hailuo-02-text-to-video-pro". - Prompt: "A glass marble rolls across a wooden desk, catches the edge, and falls in slow motion. Camera follows the marble. Soft window light, shallow depth of field." - 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": "hailuo-02-text-to-video-pro", "output": { "video_url": "https://media.runapi.ai/videos/tsk_abc123.mp4" } } ``` ## 세 단계로 WorkBuddy에서 Hailuo 사용하기 1. **RunAPI MCP 서버 추가** - WorkBuddy에서 runapi라는 이름으로 RunAPI MCP 서버를 등록하고 https://runapi.ai/mcp를 가리키도록 설정하세요. Authorization 헤더에 RUNAPI_API_KEY의 키를 읽도록 구성합니다. 이미 RunAPI를 WorkBuddy에 연결한 경우, 동일한 서버에서 Hailuo 도구가 노출됩니다 — 추가 설정이 필요 없습니다. `{ "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ` 2. **워크벤치 에이전트에 프롬프트 입력** - 자연어로 장면, 카메라 움직임, 조명을 설명하고 변형 이름을 지정하세요 — 최고 품질의 텍스트-영상을 원하면 hailuo-02-text-to-video-pro를 사용하세요. 이미지 기반 영상의 경우 소스 이미지를 첨부하거나 링크하면 에이전트가 first_frame_image_url을 사용하는 image_to_video 변형으로 피사체를 유지합니다. `Generate a video with hailuo-02-text-to-video-pro: a glass marble rolls across a wooden desk and falls in slow motion, camera following, soft window light. ` 3. **영상 URL 받기** - Hailuo 작업은 비동기입니다. WorkBuddy가 MCP 서버를 통해 상태가 completed가 될 때까지 폴링한 후, 생성된 영상 URL을 대화창에 게시합니다. pro 티어의 일반적인 처리 시간은 2분 이내입니다. `{ "task_id": "tsk_abc123", "status": "completed", "output": { "video_url": "https://media.runapi.ai/videos/tsk_abc123.mp4" } } ` ## Hailuo 도구 파라미터 | 파라미터 | 유형 | 설명 | | --- | --- | --- | | `model` | `string` | 필수. 다음 중 하나: hailuo-02-text-to-video-pro, hailuo-02-text-to-video-standard, hailuo-02-image-to-video-pro, hailuo-02-image-to-video-standard, hailuo-2.3-image-to-video-pro, hailuo-2.3-image-to-video-standard. | | `prompt` | `string` | 필수. 영상 장면, 카메라 움직임, 조명에 대한 텍스트 설명. | | `first_frame_image_url` | `string` | image_to_video 변형에 필수. 첫 번째 프레임으로 사용할 소스 이미지 URL. | | `last_frame_image_url` | `string` | 선택. 마지막 프레임으로 사용할 이미지 URL. Hailuo 02 image-to-video에서만 사용 가능. | | `duration_seconds` | `integer` | 선택. 영상 길이(초). 허용 값: 6 또는 10. standard 기본값은 10, pro는 고정값. | | `output_resolution` | `string` | 선택. 출력 해상도. 02 standard는 512p 또는 768p, 2.3 변형은 768p 또는 1080p. | ## WorkBuddy에서 Hailuo란? MiniMax의 Hailuo는 동급 최고 속도의 영상 생성기 중 하나로, 부드럽고 자연스러운 움직임과 뛰어난 디테일 유지력을 갖춘 네이티브 1080p 영상을 생성합니다. 물체 영속성, 움직임 일관성, 재질 상호작용 등 물리 시뮬레이션을 잘 처리하며, Hailuo 2.3을 통한 전용 애니메 및 스타일화 콘텐츠 모드를 제공합니다. WorkBuddy는 runapi MCP 서버를 통해 6가지 변형 전체에 접근하며, 워크벤치의 다른 모든 모델과 동일한 서버 및 RUNAPI_API_KEY를 사용합니다. ## Hailuo 활용 사례 - **숏폼 소셜 콘텐츠** - TikTok, Reels, YouTube용 빠른 영상 클립을 WorkBuddy에 요청하세요. Hailuo의 빠른 생성 속도 덕분에 워크벤치에서 여러 변형을 생성하고 최선을 선택하는 것이 실용적입니다. - **설명 및 마케팅 영상** - 자연어 브리프로 설명 영상과 마케팅 클립을 만드세요. Hailuo는 피사체 일관성을 유지하고 현실적인 조명으로 제품 클로즈업을 처리합니다. - **애니메이션 및 스타일화 콘텐츠** - 다른 영상 모델에서는 제공하지 않는 전용 렌더링 모드로 애니메 스타일 또는 일러스트 기반 영상에 Hailuo 2.3 변형을 사용하세요 — WorkBuddy 프롬프트에 변형 이름만 명시하면 됩니다. ## Hailuo + WorkBuddy 자주 묻는 질문 ### WorkBuddy에서 Hailuo 영상 생성을 사용할 수 있나요? 네. RUNAPI_API_KEY로 RunAPI를 MCP 서버로 추가하면 Hailuo 도구가 다른 모든 RunAPI 모델과 함께 표시됩니다. 워크벤치 에이전트에 장면 설명과 변형 이름을 포함한 영상 요청을 하면, 에이전트가 호출과 비동기 폴링을 자동으로 처리합니다. ### Hailuo 02와 Hailuo 2.3의 차이점은 무엇인가요? Hailuo 02는 첫 번째 프레임 및 마지막 프레임 제어를 갖춘 텍스트-영상과 이미지-영상을 모두 지원합니다. Hailuo 2.3은 이미지-영상 전용이지만, 향상된 신체 움직임, 미세 표정, 그리고 02에서는 제공되지 않는 전용 애니메·일러스트 렌더링 스타일이 추가되었습니다. WorkBuddy는 요청마다 두 모델을 전환할 수 있습니다. ### pro와 standard 가격은 어떻게 다른가요? Hailuo 02 Pro 텍스트-영상은 길이에 관계없이 생성당 57센트입니다. Standard는 기간 기반 요금 — 6초에 30센트, 10초에 50센트입니다. 이미지-영상 standard 요금은 output_resolution도 반영됩니다. 최신 요금은 RunAPI 요금 페이지를 확인하세요. ### WorkBuddy가 영상을 기다리나요, 아니면 제가 직접 폴링해야 하나요? 워크벤치 에이전트가 처리합니다. Hailuo 작업은 비동기 방식으로, 도구가 task_id를 반환하면 WorkBuddy가 MCP 서버를 통해 상태가 completed가 될 때까지 폴링한 후 영상 URL을 대화창에 게시합니다. 일반적인 생성 시간은 60~120초입니다. ### Hailuo의 출력 해상도는 어떻게 되나요? Hailuo 02 Pro는 네이티브 1080p를 출력합니다. Standard는 output_resolution 파라미터에 따라 512p 또는 768p로 출력됩니다. Hailuo 2.3 변형은 768p 또는 1080p를 지원합니다. 후처리 업스케일링은 적용되지 않습니다. - [WorkBuddy 설정 가이드 →](https://runapi.ai/ko/workbuddy.md) - 아직 연결하지 않으셨나요? WorkBuddy용 RunAPI MCP 설정 가이드를 참조하세요. - [RunAPI의 Hailuo →](https://runapi.ai/ko/models/hailuo.md) - 모든 Hailuo 변형, 가격 등급 및 API 문서를 확인하세요. ## 지금 바로 WorkBuddy에서 Hailuo를 사용해 보세요. 무료 RunAPI 키를 발급받고 WorkBuddy에 MCP 서버를 추가해 워크벤치를 벗어나지 않고 MiniMax Hailuo로 네이티브 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 Hailuo", "applicationCategory": "DeveloperApplication", "description": "RunAPI MCP 서버를 통해 WorkBuddy에서 MiniMax Hailuo로 영상을 생성하세요. 텍스트 또는 이미지로 영상 생성, 6가지 변형, 네이티브 1080p, API 키 하나로 시작하세요.", "url": "https://runapi.ai/ko/workbuddy-hailuo" }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "WorkBuddy에서 Hailuo 영상 생성을 사용할 수 있나요?", "acceptedAnswer": { "@type": "Answer", "text": "네. RUNAPI_API_KEY로 RunAPI를 MCP 서버로 추가하면 Hailuo 도구가 다른 모든 RunAPI 모델과 함께 표시됩니다. 워크벤치 에이전트에 장면 설명과 변형 이름을 포함한 영상 요청을 하면, 에이전트가 호출과 비동기 폴링을 자동으로 처리합니다." } }, { "@type": "Question", "name": "Hailuo 02와 Hailuo 2.3의 차이점은 무엇인가요?", "acceptedAnswer": { "@type": "Answer", "text": "Hailuo 02는 첫 번째 프레임 및 마지막 프레임 제어를 갖춘 텍스트-영상과 이미지-영상을 모두 지원합니다. Hailuo 2.3은 이미지-영상 전용이지만, 향상된 신체 움직임, 미세 표정, 그리고 02에서는 제공되지 않는 전용 애니메·일러스트 렌더링 스타일이 추가되었습니다. WorkBuddy는 요청마다 두 모델을 전환할 수 있습니다." } }, { "@type": "Question", "name": "pro와 standard 가격은 어떻게 다른가요?", "acceptedAnswer": { "@type": "Answer", "text": "Hailuo 02 Pro 텍스트-영상은 길이에 관계없이 생성당 57센트입니다. Standard는 기간 기반 요금 — 6초에 30센트, 10초에 50센트입니다. 이미지-영상 standard 요금은 output_resolution도 반영됩니다. 최신 요금은 RunAPI 요금 페이지를 확인하세요." } }, { "@type": "Question", "name": "WorkBuddy가 영상을 기다리나요, 아니면 제가 직접 폴링해야 하나요?", "acceptedAnswer": { "@type": "Answer", "text": "워크벤치 에이전트가 처리합니다. Hailuo 작업은 비동기 방식으로, 도구가 task_id를 반환하면 WorkBuddy가 MCP 서버를 통해 상태가 completed가 될 때까지 폴링한 후 영상 URL을 대화창에 게시합니다. 일반적인 생성 시간은 60~120초입니다." } }, { "@type": "Question", "name": "Hailuo의 출력 해상도는 어떻게 되나요?", "acceptedAnswer": { "@type": "Answer", "text": "Hailuo 02 Pro는 네이티브 1080p를 출력합니다. Standard는 output_resolution 파라미터에 따라 512p 또는 768p로 출력됩니다. Hailuo 2.3 변형은 768p 또는 1080p를 지원합니다. 후처리 업스케일링은 적용되지 않습니다." } } ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "HowTo", "name": "RunAPI를 통해 WorkBuddy에서 Hailuo 사용하는 방법", "description": "WorkBuddy에서 RunAPI를 MCP 서버로 추가하고, 워크벤치 에이전트에 Hailuo 텍스트-영상 또는 이미지-영상 변형으로 영상 생성을 요청하면 완성된 영상 URL을 받을 수 있습니다.", "step": [ { "@type": "HowToStep", "position": 1, "name": "RunAPI MCP 서버 추가", "text": "WorkBuddy에서 runapi라는 이름으로 RunAPI MCP 서버를 등록하고 https://runapi.ai/mcp를 가리키도록 설정하세요. Authorization 헤더에 RUNAPI_API_KEY의 키를 읽도록 구성합니다. 이미 RunAPI를 WorkBuddy에 연결한 경우, 동일한 서버에서 Hailuo 도구가 노출됩니다 — 추가 설정이 필요 없습니다.", "url": "https://runapi.ai/ko/workbuddy-hailuo#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "워크벤치 에이전트에 프롬프트 입력", "text": "자연어로 장면, 카메라 움직임, 조명을 설명하고 변형 이름을 지정하세요 — 최고 품질의 텍스트-영상을 원하면 hailuo-02-text-to-video-pro를 사용하세요. 이미지 기반 영상의 경우 소스 이미지를 첨부하거나 링크하면 에이전트가 first_frame_image_url을 사용하는 image_to_video 변형으로 피사체를 유지합니다.", "url": "https://runapi.ai/ko/workbuddy-hailuo#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "영상 URL 받기", "text": "Hailuo 작업은 비동기입니다. WorkBuddy가 MCP 서버를 통해 상태가 completed가 될 때까지 폴링한 후, 생성된 영상 URL을 대화창에 게시합니다. pro 티어의 일반적인 처리 시간은 2분 이내입니다.", "url": "https://runapi.ai/ko/workbuddy-hailuo#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 Hailuo", "item": "https://runapi.ai/ko/workbuddy-hailuo" } ] } ] ```