--- title: RunAPI를 통해 WorkBuddy에서 Wan 사용하기 — 영상 및 이미지 MCP 가이드 | RunAPI description: RunAPI MCP 서버를 통해 WorkBuddy에서 Alibaba Wan으로 영상과 이미지를 생성하세요. 텍스트-영상, 이미지-영상, 음성-영상, Wan 2.7 이미지 생성을 지원합니다. url: https://runapi.ai/ko/workbuddy-wan.md canonical: https://runapi.ai/ko/workbuddy-wan locale: ko site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-wan zh-CN: https://runapi.ai/zh-CN/workbuddy-wan es: https://runapi.ai/es/workbuddy-wan ja: https://runapi.ai/ja/workbuddy-wan de: https://runapi.ai/de/workbuddy-wan fr: https://runapi.ai/fr/workbuddy-wan pt-BR: https://runapi.ai/pt-BR/workbuddy-wan ko: https://runapi.ai/ko/workbuddy-wan it: https://runapi.ai/it/workbuddy-wan nl: https://runapi.ai/nl/workbuddy-wan pl: https://runapi.ai/pl/workbuddy-wan tr: https://runapi.ai/tr/workbuddy-wan zh-TW: https://runapi.ai/zh-TW/workbuddy-wan zh-HK: https://runapi.ai/zh-HK/workbuddy-wan ar: https://runapi.ai/ar/workbuddy-wan x-default: https://runapi.ai/workbuddy-wan model: wan --- > HTML version: https://runapi.ai/ko/workbuddy-wan > Site index for agents: https://runapi.ai/llms.txt # WorkBuddy에서 Wan을 사용하세요. Wan은 Alibaba의 오픈소스 영상·이미지 생성 모델로, Apache 2.0 라이선스를 적용했으며 Artificial Analysis 텍스트-영상 리더보드 1위를 기록하고 있습니다. Wan 2.2부터 2.7까지 20개 이상의 변형 — 텍스트-영상, 이미지-영상, 립싱크 음성-영상, R2V 영상 편집, 최대 4K 이미지 생성 — 을 포함합니다. RunAPI를 MCP 서버로 한 번만 추가하면 모든 Wan endpoint가 WorkBuddy 워크벤치 내에서 호출 가능한 도구가 됩니다. - [API Key 받기](https://runapi.ai/ko/login) - [문서 읽기](https://runapi.ai/ko/docs/guides) MCP 서버 하나 · 20개 이상의 Wan 변형 · Apache 2.0 오픈소스 ### 프롬프트 ```text Generate a video with Alibaba Wan 2.7 using the runapi MCP server. Requirements: - Use the RunAPI MCP tool for text-to-video generation. - Set model to "wan-2.7-text-to-video". - Set output_resolution to "1080p" for full HD output. - Prompt: "A drone shot rising over terraced rice paddies at golden hour, mist rolling through the valleys, slow upward camera tilt". - The task is async — wait for the tool to report the task as completed, then 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": "wan-2.7-text-to-video", "output": { "video_url": "https://media.runapi.ai/outputs/tsk_abc123.mp4" } } ``` ## 세 단계로 WorkBuddy에서 Wan 사용하기 1. **RunAPI MCP 서버 추가** - WorkBuddy에서 runapi라는 이름의 MCP 서버를 등록하고 streamable HTTP 방식으로 https://runapi.ai/mcp를 가리키도록 설정하세요. RUNAPI_API_KEY 환경 변수에서 키를 읽도록 구성합니다. 채팅이나 이미지용으로 RunAPI가 이미 연결된 경우, 동일한 서버에서 20개 이상의 Wan 변형 전체를 지원합니다 — 추가 설정 불필요. `export RUNAPI_API_KEY=runapi_xxx # MCP server: runapi → https://runapi.ai/mcp ` 2. **워크벤치 에이전트에 프롬프트 입력** - WorkBuddy에 생성할 내용과 사용할 Wan 변형을 알려주세요 — 텍스트-영상은 wan-2.7-text-to-video, 이미지-영상은 first_frame_image_url과 함께 wan-2.7-image-to-video, 립싱크 음성 영상은 source_audio_url과 source_image_url을 사용해 wan-2.2-a14b-speech-to-video-turbo를 요청하세요. 에이전트가 RunAPI MCP 도구를 선택하고 파라미터를 자동으로 채웁니다. `"Generate a 1080p video with wan-2.7-text-to-video: ..."` 3. **도구가 결과를 반환하도록 두기** - RunAPI MCP 도구가 작업을 생성하고, 상태가 completed가 될 때까지 비동기 폴링을 처리한 후, 완성된 영상 또는 이미지 URL을 워크벤치에 반환합니다 — 수동으로 상태를 확인할 필요가 없습니다. `status: completed → video_url` ## Wan text_to_video 파라미터 | 파라미터 | 유형 | 설명 | | --- | --- | --- | | `model` | `string` | 필수. wan-2.7-text-to-video, wan-2.6-text-to-video, wan-2.5-text-to-video, wan-2.2-a14b-text-to-video-turbo, 또는 wan-2.7-r2v. | | `prompt` | `string` | 필수. 카메라 움직임, 조명, 피사체 세부 사항을 포함한 원하는 영상 장면의 텍스트 설명. | | `output_resolution` | `string` | 선택. Wan 2.5 이상에서 720p 또는 1080p. Wan 2.2는 480p와 580p도 지원. 기본값은 720p. | | `aspect_ratio` | `string` | 선택. wan-2.7-r2v 전용. 허용 값: 16:9, 9:16, 1:1, 4:3, 3:4. | | `duration_seconds` | `integer` | 선택. wan-2.7-r2v 전용. 영상 길이(초), 2~10. | | `seed` | `integer` | 선택. 결정론적 출력을 위한 재현성 시드. | ## WorkBuddy에서 Wan이란? Alibaba의 Wan은 Artificial Analysis 텍스트-영상 리더보드 최상위를 차지한 오픈소스(Apache 2.0) 영상 모델입니다. endpoint 고정 생성을 위한 첫 번째·마지막 프레임 제어, 캐릭터 일관성을 갖춘 멀티샷 영상, 립싱크 음성-영상을 포함한 네이티브 오디오를 지원합니다. runapi MCP 서버를 통해 WorkBuddy는 단일 RUNAPI_API_KEY로 20개 이상의 Wan 변형 전체를 호출 가능한 도구로 사용할 수 있습니다. ## Wan 활용 사례 - **스토리보드에서 영상으로 변환하는 워크플로** - 첫 번째 프레임과 마지막 프레임 고정 기능을 사용하여 스토리보드 패널을 영상 시퀀스로 변환합니다. 각 클립은 지정한 키프레임에서 시작하고 끝나므로 멀티샷 프로젝트 전반에 걸쳐 시각적 연속성이 유지됩니다. - **가상 발표자 및 브랜드 마스코트** - 얼굴 이미지와 오디오 파일을 사용해 Wan의 speech-to-video 도구로 토킹헤드 영상을 생성하세요. 모델이 일관된 브랜드 대변인 콘텐츠를 위한 립싱크와 두부 움직임을 처리합니다. - **캐릭터 일관성이 있는 멀티샷 시퀀스** - 동일한 캐릭터가 여러 클립에 등장하는 대화 중심 또는 내러티브 콘텐츠를 제작합니다. Wan의 시간적 일관성이 샷 간에 얼굴과 의상을 안정적으로 유지합니다. ## Wan + WorkBuddy 자주 묻는 질문 ### WorkBuddy에서 어떤 Wan endpoint를 호출할 수 있나요? 전부 호출 가능합니다. text_to_video, image_to_video, speech_to_video, text_to_image(Wan 2.7 Image), edit_video, animate. runapi MCP 서버가 각각을 도구로 노출합니다 — 예를 들어 영상 생성에는 wan-2.7-text-to-video, 최대 4K 이미지 생성에는 wan-2.7-image를 사용합니다. ### WorkBuddy에 Wan을 어떻게 연결하나요? https://runapi.ai/mcp를 가리키는 runapi라는 이름으로 RunAPI를 MCP 서버로 추가하고, RUNAPI_API_KEY 환경 변수에 키를 설정하세요. 연결 후 WorkBuddy에 서버의 도구 목록을 요청하면 모든 Wan 변형과 RunAPI 카탈로그 전체를 바로 호출할 수 있습니다. ### Wan 2.5, 2.6, 2.7의 차이점은 무엇인가요? Wan 2.5는 1080p 출력을 도입했습니다. Wan 2.6은 영상 편집(R2V)과 더 빠른 생성을 위한 flash 변형을 추가했습니다. Wan 2.7은 이미지 생성(wan-2.7-image, 최대 4K의 wan-2.7-image-pro), 영상 편집(wan-2.7-edit-video), Artificial Analysis 리더보드를 선도하는 개선된 텍스트-영상 품질을 추가했습니다. ### WorkBuddy에서 Wan으로 음성-영상은 어떻게 작동하나요? 워크벤치 에이전트에 source_audio_url(오디오 파일)과 source_image_url(애니메이션할 얼굴)을 사용해 wan-2.2-a14b-speech-to-video-turbo를 요청하세요. Wan이 얼굴이 오디오를 말하는 립싱크 영상을 생성합니다. 출력 해상도는 480p, 580p, 720p를 지원합니다. ### Wan은 오픈소스인가요? 자체 호스팅이 가능한가요? 네. Wan은 Alibaba가 Apache 2.0 라이선스로 출시했으며 모델 가중치가 공개되어 있습니다. RunAPI를 사용하면 GPU 설정 없이도 — WorkBuddy에서 MCP 도구 하나를 호출해 영상 또는 이미지를 바로 받을 수 있습니다. 프라이버시를 위한 자체 호스팅 파이프라인이 필요한 경우, 동일한 가중치를 자체 인프라에서 실행할 수 있습니다. - [WorkBuddy 설정 가이드 →](https://runapi.ai/ko/workbuddy.md) - 아직 연결하지 않으셨나요? WorkBuddy용 RunAPI MCP 설정 가이드를 참조하세요. - [RunAPI의 Wan →](https://runapi.ai/ko/models/wan.md) - 20개 이상의 Wan 변형, 요금 티어, endpoint 문서를 확인하세요. ## 지금 바로 WorkBuddy에서 Wan을 사용해 보세요. 무료 RunAPI 키를 발급받고 WorkBuddy에 MCP 서버를 추가해 #1 순위 오픈소스 모델로 영상을 생성하세요 — 텍스트-영상, 이미지-영상, 또는 음성-영상. [모델 보기 →](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 Wan", "applicationCategory": "DeveloperApplication", "description": "RunAPI MCP 서버를 통해 WorkBuddy에서 Alibaba Wan으로 영상과 이미지를 생성하세요. 텍스트-영상, 이미지-영상, 음성-영상, Wan 2.7 이미지 생성을 지원합니다.", "url": "https://runapi.ai/ko/workbuddy-wan" }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "WorkBuddy에서 어떤 Wan endpoint를 호출할 수 있나요?", "acceptedAnswer": { "@type": "Answer", "text": "전부 호출 가능합니다. text_to_video, image_to_video, speech_to_video, text_to_image(Wan 2.7 Image), edit_video, animate. runapi MCP 서버가 각각을 도구로 노출합니다 — 예를 들어 영상 생성에는 wan-2.7-text-to-video, 최대 4K 이미지 생성에는 wan-2.7-image를 사용합니다." } }, { "@type": "Question", "name": "WorkBuddy에 Wan을 어떻게 연결하나요?", "acceptedAnswer": { "@type": "Answer", "text": "https://runapi.ai/mcp를 가리키는 runapi라는 이름으로 RunAPI를 MCP 서버로 추가하고, RUNAPI_API_KEY 환경 변수에 키를 설정하세요. 연결 후 WorkBuddy에 서버의 도구 목록을 요청하면 모든 Wan 변형과 RunAPI 카탈로그 전체를 바로 호출할 수 있습니다." } }, { "@type": "Question", "name": "Wan 2.5, 2.6, 2.7의 차이점은 무엇인가요?", "acceptedAnswer": { "@type": "Answer", "text": "Wan 2.5는 1080p 출력을 도입했습니다. Wan 2.6은 영상 편집(R2V)과 더 빠른 생성을 위한 flash 변형을 추가했습니다. Wan 2.7은 이미지 생성(wan-2.7-image, 최대 4K의 wan-2.7-image-pro), 영상 편집(wan-2.7-edit-video), Artificial Analysis 리더보드를 선도하는 개선된 텍스트-영상 품질을 추가했습니다." } }, { "@type": "Question", "name": "WorkBuddy에서 Wan으로 음성-영상은 어떻게 작동하나요?", "acceptedAnswer": { "@type": "Answer", "text": "워크벤치 에이전트에 source_audio_url(오디오 파일)과 source_image_url(애니메이션할 얼굴)을 사용해 wan-2.2-a14b-speech-to-video-turbo를 요청하세요. Wan이 얼굴이 오디오를 말하는 립싱크 영상을 생성합니다. 출력 해상도는 480p, 580p, 720p를 지원합니다." } }, { "@type": "Question", "name": "Wan은 오픈소스인가요? 자체 호스팅이 가능한가요?", "acceptedAnswer": { "@type": "Answer", "text": "네. Wan은 Alibaba가 Apache 2.0 라이선스로 출시했으며 모델 가중치가 공개되어 있습니다. RunAPI를 사용하면 GPU 설정 없이도 — WorkBuddy에서 MCP 도구 하나를 호출해 영상 또는 이미지를 바로 받을 수 있습니다. 프라이버시를 위한 자체 호스팅 파이프라인이 필요한 경우, 동일한 가중치를 자체 인프라에서 실행할 수 있습니다." } } ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "HowTo", "name": "RunAPI를 통해 WorkBuddy에서 Wan 사용하는 방법", "description": "WorkBuddy에서 RunAPI를 MCP 서버로 추가하고 워크벤치 에이전트에 요청하면, RunAPI를 통해 Wan 영상·이미지 도구를 호출합니다.", "step": [ { "@type": "HowToStep", "position": 1, "name": "RunAPI MCP 서버 추가", "text": "WorkBuddy에서 runapi라는 이름의 MCP 서버를 등록하고 streamable HTTP 방식으로 https://runapi.ai/mcp를 가리키도록 설정하세요. RUNAPI_API_KEY 환경 변수에서 키를 읽도록 구성합니다. 채팅이나 이미지용으로 RunAPI가 이미 연결된 경우, 동일한 서버에서 20개 이상의 Wan 변형 전체를 지원합니다 — 추가 설정 불필요.", "url": "https://runapi.ai/ko/workbuddy-wan#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "워크벤치 에이전트에 프롬프트 입력", "text": "WorkBuddy에 생성할 내용과 사용할 Wan 변형을 알려주세요 — 텍스트-영상은 wan-2.7-text-to-video, 이미지-영상은 first_frame_image_url과 함께 wan-2.7-image-to-video, 립싱크 음성 영상은 source_audio_url과 source_image_url을 사용해 wan-2.2-a14b-speech-to-video-turbo를 요청하세요. 에이전트가 RunAPI MCP 도구를 선택하고 파라미터를 자동으로 채웁니다.", "url": "https://runapi.ai/ko/workbuddy-wan#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "도구가 결과를 반환하도록 두기", "text": "RunAPI MCP 도구가 작업을 생성하고, 상태가 completed가 될 때까지 비동기 폴링을 처리한 후, 완성된 영상 또는 이미지 URL을 워크벤치에 반환합니다 — 수동으로 상태를 확인할 필요가 없습니다.", "url": "https://runapi.ai/ko/workbuddy-wan#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 Wan", "item": "https://runapi.ai/ko/workbuddy-wan" } ] } ] ```