curl-X POST 'https://pollo.ai/api/platform/v1/generation/alibaba/wan-v2-1/video'\-H'Content-Type: application/json'\-H'x-api-key: YOUR_API_KEY'\-d'{ "input": { "prompt": "A cinematic shot of a golden retriever running through a field of sunflowers at sunset, warm rim light, shallow depth of field", "mode": "fast", "duration": 5, "aspectRatio": "16:9" }}'
선택적으로, 작업 성공 또는 실패 시 콜백을 수신하기 위해 webhookUrl을 포함할 수 있습니다.
선택적 요청 필드
{"input":{"prompt":"A cinematic shot of a golden retriever running through a field of sunflowers at sunset, warm rim light, shallow depth of field","mode":"fast","duration":5,"aspectRatio":"16:9"},"webhookUrl":"https://example.com/webhooks/pollo"}
개요
선택한 엔드포인트 및 모드에 대한 입력 필드입니다.
필드
유형
필수의
화면 설명
prompt
string
예
Text prompt describing the content to generate.
mode
string
아니요
Generation mode of the model (e.g. a faster or higher-quality tier).
Wan 2.1은 Alibaba의 Wan 팀이 개발한 고급 AI 모델로, 텍스트 설명이나 이미지에서 고품질 영상을 생성합니다.
Pollo API의 Wan 2.1을 사용하면 개발자가 앱에 text-to-video와 image-to-video를 추가하고, 여러 화면비의 5초 클립에 대해 빠른 초안용 fast 모드 또는 더 높은 품질의 pro 모드를 선택할 수 있습니다.
Wan 2.1 API 주요 기능
이중 언어 텍스트 효과
Wan 2.1은 중국어와 영어 문자를 장면에 직접 그려 넣기 때문에, 프레임이 진행되어도 제목, 라벨, 캡션이 노이즈로 무너지지 않고 형태를 유지합니다.
사실적인 물리 표현
움직임이 중력과 운동량을 따르므로, 떨어지는 물체, 흐르는 천, 이동하는 무게 중심이 자연스럽게 표현됩니다. 덕분에 생성된 액션이 자세히 봐도 붕 뜨거나 고무처럼 보이지 않고 현실감 있게 유지됩니다.
복잡한 모션 처리
군중이 길을 건너는 장면부터 팔·다리와 도구가 동시에 움직이는 장면까지, 여러 요소의 움직임이 일관되게 유지되어 클립 중간에 피사체가 번지거나 구조가 무너지지 않습니다.
텍스트 및 이미지 가이드
작성한 프롬프트로 시작하거나 기존 정지 이미지를 애니메이션화할 수 있으므로, Wan 2.1은 아이디어 우선 콘셉트와 고정된 첫 프레임 기반의 에셋 우선 워크플로 모두를 지원합니다.
Fast 및 Pro 모드
빠른 반복이 필요하면 빠른 패스를, 디테일이 중요하면 정교한 패스를 선택할 수 있으므로, 통합을 바꾸지 않고도 초안과 최종 렌더를 하나의 모델로 처리할 수 있습니다.
Wan 2.1 API 활용 사례
로컬라이즈드 영상 캡션: 화면 내 중국어 또는 영어 텍스트가 포함된 클립을 생성하여, 이중 언어 캠페인, 자막형 설명 영상, 지역별 스토어프런트 콘텐츠에 활용.
간판 및 매장 전경 장면: 상점 간판, 메뉴, 포스터에 실제로 읽을 수 있는 단어가 표시되는 샷을 제작해 리테일·호스피탈리티 목업에 활용.
물리 기반 액션: 액체 따르기, 소품 구르기, 천의 움직임 등을 애니메이션화해, 무게감이 설득력을 좌우하는 데모에 활용.
이미지 재애니메이션: 정지 프레임을 입력하여 원래 구도를 유지한 채 움직이게 만들 수 있으므로, 사진→클립 및 레퍼런스 기반 도구에 유용.
타이틀 카드 생성: 키네틱 텍스트와 모션이 하나의 생성 샷에 함께 나타나는 짧은 인트로/아웃트로 시퀀스 제작.
군중 및 다중 피사체 샷: 여러 움직이는 요소가 많은 장면에서도 요소 간 구분이 유지되어, 이스터블리싱 샷과 배경 플레이트에 적합.
빠른 콘셉트 초안: fast 모드로 설명된 장면을 빠르게 미리 본 뒤, 정교한 pro 렌더에 연산 리소스를 투입.
세로형 소셜 클립: 가로 소스를 크롭하거나 재프레이밍하지 않고 피드·스토리용 세로 포맷 숏폼 영상을 출력.
Wan 2.1 API 사용 방법
API 키 받기: Pollo API 계정을 만들고 개발자 대시보드에서 API 키를 생성합니다.
모델 선택:/generation/wanx/wanx-v2-1의 Wan 2.1 엔드포인트로 요청을 보냅니다.
입력 추가: text-to-video용 prompt와 aspectRatio(16:9, 9:16, 4:3, 3:4 또는 1:1)를 제공하거나, image-to-video용 image URL을 전달한 뒤 mode를 fast 또는 pro로 설정합니다. 클립 length는 5초입니다.
생성 및 가져오기: 작업을 제출하고 반환된 작업 상태를 폴링한 다음, 처리에 성공하면 완성된 영상을 다운로드합니다.
Wan 2.1 API 프롬프트 작성 베스트 프랙티스
프롬프트를 장면 브리프로 생각해. 피사체, 움직임, 화면 내 텍스트(있다면 정확한 문구), 프레이밍, 배경 설정을 명확히 적어 주면 Wan 2.1이 렌더링해야 할 목표를 분명하게 잡을 수 있습니다.
간단한 프롬프트 공식
피사체 + 구체적인 움직임 + 화면 내 정확한 텍스트(있는 경우) + 카메라 프레이밍 + 배경 및 조명
꼭 확인할 점
텍스트는 정확히 따옴표로: 화면에 넣고 싶은 문구를 프롬프트에 그대로 넣어. Wan 2.1은 입력받은 중국어/영어 문자를 렌더링합니다.
물리적 움직임을 설명: 기울기, 따르기, 흔들림처럼 어떻게 움직이는지 명시하면 물리 엔진이 구체적인 목표를 잡을 수 있습니다.
집중된 한 가지 동작 유지: 서로 경쟁하는 여러 이벤트보다, 단일하고 명확한 움직임이 5초 클립 전반에서 더 잘 유지됩니다.
화면비를 초기에 설정: 최종 배포처에 맞게 프레이밍하고, 소셜은 세로, 가로 장면은 와이드를 선택합니다.
의도에 맞게 모드 사용: fast 모드로 초안 만든 뒤, 더 깔끔한 디테일이 필요할 때 pro 모드로 재렌더해.
프롬프트 예시
이중 언어 매장 간판
"해질녘의 작은 국수 가게, 그릇에서 김이 올라오고 문 위의 빛나는 간판에는 영어와 중국어로 'Open'이 적혀 있다. 따뜻한 등불 조명, 느린 푸시인, 부드러운 아웃포커스의 지나가는 사람들, 사실적인 스타일."
물리 중심 주방 샷
"꿀이 병에서 팬케이크 더미 위로 천천히 흘러내리며, 흐름이 비틀리고 고이면서 점성이 보이게 표현된다. 탑다운 카메라, 부드러운 아침 창가 빛, 설득력 있는 흐름에 초점을 둔 깔끔한 사실적 스타일."
애니메이션 타이틀 카드
"굵은 영어 텍스트 'CHAPTER ONE'이 바람 부는 초원 위에 한 글자씩 형성된다. 풀잎은 바람에 휘어진다. 안정적인 와이드 샷, 흐린 조명, 미묘한 움직임의 미니멀 그래픽 스타일."
거리 군중 장면
"여러 상인이 손짓하고 쇼핑객이 가판대 사이를 오가는 분주한 시장 거리, 과일과 천이 보인다. 핸드헬드 미디엄 샷, 밝은 한낮 조명, 작은 움직임 디테일이 많은 자연스러운 사실적 스타일."
Wan 2.1 vs Kling 1.6 vs Hunyuan Video
기능
Wan 2.1
Kling 1.6
Hunyuan Video
이중 언어 화면 내 텍스트
✅ 중국어 및 영어 렌더링
❌ 제한적인 텍스트 정확도
❌ 제한적인 텍스트 정확도
물리적 사실감
✅ 뛰어난 무게감과 움직임
✅ 우수한 모션 제어
✅ 부드럽고 사실적인 움직임
복잡한 다중 피사체 모션
✅
✅
✅
입력 유형
텍스트 및 이미지
텍스트 및 이미지
텍스트 및 이미지
클립 길이
5초
짧은 디렉티드 클립
짧은 클립
추천 용도
영상 내 텍스트와 물리 모션
디렉티드 캐릭터 모션
오픈 모델 사실적 영상
왜 Wan 2.1 API를 선택할까?
Wan 2.1은 한 샷에 실제로 읽히는 단어와 설득력 있는 움직임이 동시에 필요할 때 강점을 보입니다. 이중 언어 캡션과 간판부터 물리 기반 액션까지 한 클립에서 구현할 수 있습니다.
Pollo API를 통해서는 하나의 API 키로 Wan 2.1과 300개 이상의 선도적인 영상·이미지 모델에 접근할 수 있으며, 깔끔한 문서, 작업 상태 폴링, Fal AI보다 저렴한 생성 비용을 제공합니다.
Pollo API의 Wan 2.1 엔드포인트로 시작해 이중 언어·물리 인지 영상 기능을 출시하고, 통합을 건드리지 않은 채 Kling 및 Hunyuan과 비교하여 보세요.
Wan 2.1 API FAQ
Wan 2.1이란?
Wan 2.1은 Alibaba Cloud의 멀티모달 영상 파운데이션 모델로, 사실적인 물리 표현, 복잡한 모션, 그리고 텍스트 또는 이미지 입력에서 생성된 영상 내부의 중국어·영어 텍스트 렌더링으로 잘 알려져 있습니다.
Wan 2.1 API는 텍스트와 이미지 입력을 지원하나요?
네. 작성된 프롬프트에서 생성하거나 이미지 URL을 애니메이션화할 수 있으므로, 콘셉트 우선과 에셋 우선 영상 워크플로 모두에 맞습니다.
Wan 2.1은 영상 안에 텍스트를 렌더링할 수 있나요?
네. 중국어와 영어 문자를 장면에 직접 그려 넣어, 샷이 움직여도 간판·제목·캡션의 가독성을 유지합니다.
사용 가능한 클립 길이와 형식은 무엇인가요?
Wan 2.1은 5초 클립을 생성하며, 가로·세로·정사각형을 포함한 여러 화면비를 요청별로 선택해 지원합니다.
fast 모드와 pro 모드의 차이는 무엇인가요?
fast 모드는 초안용 빠른 반복에 유리하고, pro 모드는 최종 렌더를 위해 더 많은 연산을 사용하여 디테일을 정교하게 다듬습니다.
왜 Pollo API를 통해 Wan 2.1을 실행해야 하나요?
Pollo API는 Wan 2.1과 300개 이상의 다른 모델을 하나의 통합으로 제공하며, 문서, 작업 추적, 그리고 유사 제공업체 대비 더 낮은 생성 비용을 제공합니다.
