소개
Wan 2.2 Animate는 확정된 캐릭터 이미지와 따로 준비한 모션 레퍼런스로 그 캐릭터가 연기하는 새 클립을 만듭니다. 외형과 움직임이 이미 서로 다른 자료에서 정해져 있어서 하나의 소스에 둘 다 요구하고 싶지 않을 때 쓰십시오.
모드는 두 가지입니다. animation_mode를 animate로 두면 이미지 속 캐릭터가 구동 영상의 움직임대로 움직이고, replace로 두면 구동 영상 속 인물이 이미지 속 인물로 바뀌고 영상의 장면은 그대로 유지됩니다. 출력은 구동 영상과 같은 2~30초이며 해상도는 480p 또는 720p입니다.
핵심 기능 및 하이라이트
깔끔한 A 포즈가 긴 프롬프트보다 낫다
공개된 레퍼런스 이미지가 바로 이 엔드포인트가 원하는 이미지입니다. 전신이 화면에 들어오고, 중립적인 A 포즈에, 이음새 없는 배경과 고른 조명입니다. 출력의 모습은 모두 이 이미지에서 나옵니다. 잘리거나 많이 가려진 이미지는 그것으로 만드는 모든 클립의 한계가 되며, 어떤 프롬프트로도 되살릴 수 없습니다.
클립 길이는 원본과 같으며 최대 30초
출력은 구동 영상과 같은 길이이며, 구동 영상은 2~30초여야 하므로 2분짜리 원본은 먼저 잘라야 합니다. 과금은 견적에 쓴 상한이 아니라 실제로 전달된 초를 따르므로, 올리기 전에 구동 영상을 자르는 것이 비용을 조절하는 가장 직접적인 방법입니다.
720p 값을 치르기 전에 480p로 닮았는지 확인하기
공개된 클립은 같은 이미지를 레퍼런스 영상으로 움직인 것입니다. 같은 버건디 상의, 같은 와이드 팬츠 그대로 이번에는 회전하는 중입니다. 해상도는 요금 구간이며 720p가 480p보다 초당 비용이 높으므로, 먼저 쓸 수 있는 가장 짧은 구동 영상으로 480p에서 정체성과 실루엣이 유지되는지 확인하십시오.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
animation_mode | 아니요 | Animate는 이미지 속 캐릭터를 구동 영상의 동작으로 움직입니다. Replace는 구동 영상의 인물을 이미지 속 캐릭터로 바꾸고 장면은 그 영상 그대로 둡니다. |
image_url | 예 | 캐릭터 이미지입니다. 여기 있는 인물이 움직이게 되므로, 실루엣이 뚜렷하고 빛이 고른 전신 원본 컷을 쓰세요. 1자 이상 |
video_url | 예 | 레퍼런스 영상이며 길이는 2~30초여야 합니다. MP4를 업로드하거나 MP4·MOV URL을 지정하세요. 1자 이상 |
resolution | 아니요 | 480p 또는 720p이고 기본값은 720p이며 가격 구간이기도 합니다. 480p에서 전이를 검증하고, 실제로 내보낼 컷만 다시 렌더링하세요. |
prompt | 아니요 | 선택이고 최대 2000자입니다. 애니메이션 스타일과 내용을 안내합니다. 2000자 이하 |
seed | 아니요 | 0에서 2147483647까지이고 0은 무작위 seed를 요청합니다. 같은 레퍼런스 영상으로 두 실행을 비교할 때는 고정하세요. |
요금
출력 길이는 구동 영상을 그대로 따르며 그 초 단위로 과금됩니다.
| 사양 | 요금 |
|---|---|
| $0.053 / 초 |
| $0.11 / 초 |
활용 사례
기존 영상에 캐릭터 넣기
animation_mode를 replace로 두면 영상은 자체 장면을 유지한 채 구동 영상 속 인물만 이미지의 캐릭터로 바뀝니다. 장소는 이미 영상으로 있고 연기하는 사람만 바꾸면 될 때 쓰십시오.
캐릭터 시트 한 장으로 짧은 루프 만들기
최대 30초면 피드 루프, 스티커, 리액션 클립에 충분합니다. 이미지 한 장은 그대로 두고 구동 영상을 바꿔 손 흔들기, 돌아서기, 어깨 으쓱하기 같은 제스처 라이브러리를 만들면, 같은 레퍼런스 이미지를 공유하므로 모두 같은 캐릭터로 보입니다.
댄스와 퍼포먼스 루틴
캐릭터 이미지와 원하는 루틴의 구동 영상을 준비하십시오. 의상과 체형은 이미지가 고정하고, 타이밍, 무게 중심, 카메라는 영상에서 옵니다. 작업의 한계는 권리입니다. 이미지와 구동 영상 모두에 대한 권리가 필요하며 결과물의 사용에 대한 책임은 사용자에게 있습니다.
긴 렌더링 전에 이미지 시험하기
480p로 5초짜리 전이를 돌려 새 캐릭터 이미지가 움직임 속에서도 얼굴, 손, 실루엣을 유지하는지 확인하십시오. 30초 전체 작업에 쓰기 전에 좋지 않은 이미지를 가장 저렴하게 걸러 내는 방법입니다.
프롬프트 가이드 및 실전 팁
캐릭터 이미지 만들기
전신이 화면에 들어오게, 중립적인 포즈로, 단색 배경에 고른 조명을 쓰십시오. 이 이미지가 그것으로 움직일 모든 클립의 얼굴, 의상, 비율을 정하므로, 몇 장 만들어 보고 걸러 낸 뒤 확정할 가치가 있습니다. 이미지에서 얼굴이나 인물을 찾지 못하면 작업은 invalid_request로 거절됩니다. 공개된 이미지는 다음 프롬프트로 만들었습니다. ‘Full-body studio photograph of an adult female dancer standing in a neutral A-pose against a seamless grey backdrop, wearing a cropped burgundy tank top and high-waisted wide-leg trousers, barefoot, hair tied back, even soft studio lighting, sharp full-length framing, clean reference plate for character animation.’
구동 영상을 필요한 초만큼 자르기
출력 길이는 원본 길이와 같고, 원본은 2~30초여야 하며, 비용은 전달된 초만큼 냅니다. MP4 파일을 올리거나 MP4 또는 MOV 파일로 바로 연결되는 링크를 보내십시오. 영상을 재생만 하는 웹 페이지는 파일이 아니어서 호출이 실패하며, 비용은 환불됩니다.
프롬프트는 정체성이 아니라 스타일에
prompt는 선택이며 최대 2000자입니다. 애니메이션의 스타일과 내용을 이끌며, 정체성은 캐릭터 이미지가 맡습니다. 같은 구동 영상으로 두 번의 실행을 비교하려면 seed를 고정하십시오.
반복하기 전에 결과 확인하기
두 입력은 모두 필수이며 서로 바꿔 쓸 수 없습니다. 정체성은 이미지에서, 움직임은 영상에서 옵니다. animate 모드에서는 배경이 캐릭터 이미지 쪽에 남습니다. 레퍼런스 실행에서 구동 영상은 주방에서 찍었지만 결과는 이미지의 회색 스튜디오 배경을 유지했고, 넘어온 것은 움직임과 카메라뿐이었습니다. 긴 원본은 압축되지 않으므로 올리기 전에 자르십시오.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/wan-2.2-animate/character-animation",
"input": {
"animation_mode": "animate",
"image_url": "https://example.com/reference.png",
"resolution": "720p",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.




























