curl-X POST 'https://pollo.ai/api/platform/v1/generation/alibaba/wan-v2-5/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", "negativePrompt": "blurry, low quality, distorted, watermark, text", "duration": 5, "resolution": "480p", "aspectRatio": "1:1", "generateAudio": true }}'
선택적으로, 작업 성공 또는 실패 시 콜백을 수신하기 위해 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","negativePrompt":"blurry, low quality, distorted, watermark, text","duration":5,"resolution":"480p","aspectRatio":"1:1","generateAudio":true},"webhookUrl":"https://example.com/webhooks/pollo"}
개요
선택한 엔드포인트 및 모드에 대한 입력 필드입니다.
필드
유형
필수의
화면 설명
audio
string
아니요
Reference audio URL (HTTP(S)).
prompt
string
예
Text prompt describing the content to generate.
negativePrompt
string
아니요
Text describing elements to avoid in the generated output.
duration
number
아니요
The duration of the generated video, in seconds.
resolution
string
아니요
Output resolution of the generated media (e.g. 720p, 1080p, 2K, 4K). Values are case-insensitive.
aspectRatio
string
아니요
Output aspect ratio, as width:height (e.g. 16:9).
seed
integer
아니요
Random seed for reproducible generation.
generateAudio
boolean
아니요
Generate natural-sounding, fitting audio for the output video.
Wan 2.5는 영상에 맞는 오디오를 생성하거나 업로드한 오디오를 가이드로 사용할 수 있습니다. 그래서 소리, 움직임, 타이밍이 함께 맞아야 하는 클립에 유용합니다.
Pollo API의 Wan 2.5를 사용하면 개발자는 앱에 텍스트-투-비디오와 이미지-투-영상 생성을 추가할 수 있습니다. 기본 오디오, 네거티브 프롬프트, 그리고 480P·720P·1080P의 모든 해상도에서 모든 화면비를 지원합니다.
Wan 2.5 API의 핵심 기능
기본 오디오 생성
Wan 2.5는 기본적으로 영상과 동기화된 사운드를 생성합니다. 그래서 주변 소음, 효과음, 장면 오디오가 따로 후반 사운드 작업 없이 한 번에 함께 제공됩니다.
오디오 기반 비디오
오디오 트랙을 넣으면 Wan 2.5가 그에 맞춰 움직임과 타이밍을 구성하여, 캐릭터 동작이나 장면 리듬을 사용자가 제공한 소리에 맞춰 정렬해.
향상된 모션 물리
움직임이 더 그럴듯한 물리 법칙을 따르기 때문에, 팔다리·천·이동 물체가 프레임 사이에서 미끄러지거나 떨리기보다 무게감과 연속성을 갖고 움직여.
더 정교한 프롬프트 이해
모델이 설명된 피사체, 동작, 연출을 더 정확히 읽어내서 사용자가 쓴 내용이 장면에 더 잘 반영되고, 아이디어당 재생성 횟수를 줄여줘.
유연한 프레이밍
모든 해상도에서 모든 화면비가 동작하므로 정사각형, 세로형, 와이드스크린 결과물을 하나의 모델에서 만들 수 있고, 나중에 크롭이나 재프레이밍이 필요 없어.
네거티브 프롬프트 제어
제외할 요소를 지정하면 Wan 2.5가 그걸 피해서 생성합니다. 장면에 원치 않는 물체, 색상, 아티팩트가 계속 끼어들 때 더 깔끔한 결과를 얻을 수 있습니다.
Wan 2.5 API 활용 사례
사운드 싱크 설명 영상: 내레이션이나 효과음이 화면 동작과 맞는 짧은 사용법 클립을 생성하여, 제품 도구에서 한 번의 호출로 오디오 포함 영상을 제공할 수 있습니다.
오디오 주도 캐릭터 클립: 음성 또는 음악 트랙을 업로드하고 Wan 2.5가 캐릭터의 움직임과 템포를 이끌도록 하여 대사/퍼포먼스 샷을 만들 수 있습니다.
앰비언트 장면 루프: 급류 소리나 장작 타는 소리 같은 생성 오디오를 포함한 자연/환경 클립을 만들어 추가 편집 없이 분위기를 완성해.
이미지-투-모션: 정지 이미지를 넣어 원래 구도를 유지한 채 움직임과 소리를 더한 짧은 모션 샷으로 애니메이션화해.
세로형 소셜 콘텐츠: 9:16 클립을 풀해상도로 제작하고, 기본 오디오를 활용하여 파이프라인의 수동 사운드 단계를 건너뛸 수 있습니다.
멀티 화면비 광고 변형: 하나의 모델로 같은 콘셉트를 정사각형, 세로형, 와이드스크린으로 생성하여 여러 배치 지면을 한 번에 커버합니다.
리듬 매칭 몽타주: 비트나 음악 베드를 제공하면 모델이 컷과 움직임 타이밍을 맞춰 음악 반응형 크리에이터 도구를 만들 수 있습니다.
프롬프트 충실 프로토타이핑: 더 긴 제작에 들어가기 전에 향상된 프롬프트 준수로 브리프를 반영한 장면을 빠르게 미리 볼 수 있습니다.
Wan 2.5 API 사용 방법
API 키 받기: Pollo API 계정을 만들고 개발자 대시보드에서 API 키를 생성합니다.
모델 선택:/generation/wanx/wan-v2-5-preview의 Wan 2.5 엔드포인트로 요청을 보냅니다.
입력 추가: 텍스트-투-비디오는 prompt, 이미지-투-비디오는 image URL을 제공한 뒤 resolution(480P, 720P, 1080P)과 length(5 또는 10)를 설정합니다. 오디오 기반 생성을 하려면 audioUrl을 전달하고, 생성 오디오를 쓰려면 wanAudio를 켜 둡니다.
생성 및 가져오기: 작업을 제출하고 반환된 작업 상태를 폴링한 다음, 처리 성공 시 완성된 영상을 다운로드합니다.
Wan 2.5 API 프롬프트 작성 모범 사례
화면과 소리를 함께 고려해서 작성하세요. 피사체와 동작을 먼저 명시하고, 기대하는 오디오, 프레이밍, 무드를 설명하면 모델이 트랙에 맞춰 움직임을 정렬할 수 있습니다.
간단한 프롬프트 공식
피사체 + 구체적인 동작 + 오디오/사운드 단서 + 카메라와 프레이밍 + 배경과 무드
확인해야 할 포인트
사운드를 구체적으로 설명: 발소리, 파도 소리, 대사 한 줄처럼 원하는 오디오를 명확히 적어 기본 오디오가 목표를 갖게 해.
움직임을 오디오에 맞추기: 트랙을 제공할 때는 발걸음이 비트에 맞게 떨어지는 식으로 움직임이 어떻게 따라야 하는지 설명해.
화면비는 초반에 선택: 정사각형, 세로형, 와이드스크린을 처음부터 정해 최종 배치에 맞는 구도로 구성합니다.
네거티브 프롬프트 사용: 장면에 잡동사니, 강한 조명, 원치 않는 요소가 계속 추가되면 제외할 항목을 나열해.
명확한 동작 하나 유지: 5초 또는 10초 클립마다 하나의 동작에 집중하면 화면과 소리의 일관성을 유지할 수 있습니다.
반복을 위한 시드 설정: 마음에 든 프레이밍을 유지하며 결과를 반복 개선하고 싶다면 같은 시드를 재사용합니다.
프롬프트 예시
환경음 장면
"뜨거운 기름 위에 얇게 썬 양파가 닿자 주철 팬에서 지글거리는 소리가 나고, 김이 올라오며, 나무 주걱이 천천히 저어 준다. 어울리는 지글거림과 젓는 소리를 생성합니다. 탑다운 클로즈업, 따뜻한 주방 조명, 사실적인 스타일, 여유로운 움직임."
오디오 기반 퍼포먼스
"거리의 아코디언 연주자가 제공된 음악 트랙의 박자에 맞춰 몸을 흔들고 풀무를 밀고 당기며, 발끝으로 보도를 두드린다. 해질녘 미디엄 샷, 부드러운 가로등 빛, 오디오 리듬에 촘촘히 동기화된 움직임."
자연 분위기
"좁은 숲속 폭포가 맑은 웅덩이로 떨어지고, 물안개가 흘러가며, 물보라에 고사리가 떨린다. 흐르는 물소리와 새 지저귐을 생성합니다. 느린 푸시 인, 반점처럼 비치는 아침 햇살, 세로 9:16 프레이밍, 차분하고 사실적인 톤."
이미지 주도 애니메이션
"제공된 등불 밝힌 야시장 사진을 애니메이션화해: 음식 가판대에서 피어오르는 김, 흔들리는 전구 줄조명, 손을 흔드는 상인. 부드러운 군중 웅성거림과 환경 오디오를 추가합니다. 원래 구도를 유지하고, 카메라는 천천히 좌우로 드리프트."
Wan 2.5 vs Veo 3.1 vs Kling 2.6
기능
Wan 2.5
Veo 3.1
Kling 2.6
기본 오디오 생성
✅ 기본 생성 사운드
✅ 기본 오디오
❌ 비디오 전용
업로드 트랙 기반 오디오 주도
✅
❌
❌
텍스트 및 이미지 입력
✅
✅
✅
화면비
모든 해상도에서 모든 비율
고정 세트
고정 세트
해상도 옵션
480P, 720P, 1080P
최대 1080P
최대 1080P
클립 길이
5초 또는 10초
짧은 디렉션형 클립
짧은 디렉션형 클립
추천 용도
사운드 싱크/오디오 주도 비디오
대사 중심 장면
캐릭터 모션 제어
왜 Wan 2.5 API를 선택해야 하나요?
Wan 2.5는 오디오를 자동으로 생성하든 업로드한 트랙에 맞춰 모션을 구성하든, 화면과 소리를 함께 필요로 하는 제품에 잘 맞습니다. 향상된 물리 표현과 더 높은 프롬프트 준수도 제공합니다.
Pollo API를 통해 하나의 API 키로 Wan 2.5를 포함한 300개 이상의 주요 영상/이미지 모델에 접근할 수 있고, 깔끔한 문서, 작업 상태 폴링, 웹훅도 함께 제공됩니다.
Pollo API의 Wan 2.5 엔드포인트로 오디오 네이티브 비디오 기능을 먼저 출시하고, 이후 Veo, Kling, Sora와 비교해도 통합 코드는 건드릴 필요가 없어.
Wan 2.5 API FAQ
Wan 2.5는 무엇인가요?
Wan 2.5는 wanx의 영상 생성 모델로, 기본 오디오, 오디오 기반 모션, 향상된 물리 표현, 더 정교한 프롬프트 이해를 갖춘 텍스트-투-비디오와 이미지-투-비디오를 지원합니다.
Wan 2.5 API는 오디오를 생성하나요?
네. 기본적으로 영상과 동기화된 사운드를 생성하고, 오디오 트랙을 업로드해 클립의 움직임과 타이밍을 그에 맞출 수도 있습니다.
Wan 2.5는 어떤 입력을 지원하나요?
텍스트 프롬프트로 생성하거나 이미지 URL을 애니메이션화할 수 있고, 필요하면 오디오 파일도 제공할 수 있으므로 아이디어 중심, 에셋 중심, 사운드 중심 워크플로에 유연해.
사용 가능한 해상도와 길이는 무엇인가요?
Wan 2.5는 어떤 화면비에서도 480P, 720P, 1080P를 출력하며, 요청마다 5초 또는 10초 클립 길이를 선택할 수 있습니다.
오디오 기반 생성은 어떻게 작동하나요?
오디오 URL을 제공하면 Wan 2.5가 해당 트랙을 중심으로 영상의 움직임과 페이싱을 구성하여, 자체 오디오를 생성하는 대신 소리에 맞춰 움직임을 정렬해.
왜 Pollo API를 통해 Wan 2.5를 실행해야 하나요?
Pollo API는 Wan 2.5와 300개 이상의 다른 모델을 하나의 통합으로 제공하고, 문서, 작업 추적, 웹훅, 그리고 유사 제공업체 대비 더 낮은 비용의 생성을 지원합니다.
