Wan 2.2 Animate API 레퍼런스
레퍼런스 영상으로 캐릭터 사진을 움직여요
PopNow API 키 하나로 내 코드에서 Wan 2.2 Animate을(를) 호출할 수 있습니다. 보낼 모델 ID, 이 모델이 받는 모든 입력 필드, 요청 한 번에 드는 크레딧, 터미널에 붙여 넣으면 바로 실행되는 요청을 정리했습니다.
파라미터 설명은 모델의 입력 schema에서 가져오므로 영어로만 제공됩니다.
한눈에 보기
- 제작사
- Alibaba
- 결과물
- 영상
- 최저가
- 7.95크레딧 결과물 1초당 ($0.0795)
- 평균 소요 시간
- 약 345초
1크레딧 = 0.01달러. 작업이 접수되면 가능한 최대 금액을 먼저 잡아 두고, 끝나면 실제 사용량으로 정산합니다(정수 크레딧으로 올림, 남는 금액은 반환). 실패한 작업에는 과금하지 않습니다. 실행 전에 정확한 금액이 궁금하면 POST /api/v1/jobs/quote를 호출하세요.
모션 컨트롤
alibaba/wan-2.2-animate/character-animation
요금
| 옵션 | 크레딧 (결과물 1초당) | 미국 달러 |
|---|---|---|
480p | 7.95 | $0.0795 |
720p | 16.5 | $0.165 |
파라미터
| 필드 | 타입 | 기본값 | 허용 값 | 설명 |
|---|---|---|---|---|
image_url필수 | string | — | — | Character image. The person in this image is the one that gets animated. |
video_url필수 | string | — | — | Driving video, 2 to 30 seconds long; upload an MP4, or pass an MP4 or MOV URL. Its motion is transferred to the character and its length sets the output length. Videos outside that range are rejected before any charge. |
animation_mode선택 | string | animate | animate, replace | animate drives the character in the image with the motion of the driving video; replace swaps the person in the driving video for the one in the image. |
resolution선택 | string | 720p | 480p, 720p | Output video resolution. |
prompt선택 | string | — | 최대 2,000자 | Optional description of the motion, used to guide animation style and content. |
seed선택 | integer | — | 0~2147483647 | Random seed; zero requests a random seed. |
요청 예제
이 요청은 그대로 실행됩니다. 빠진 필드는 기본값을 씁니다. 먼저 키를 환경 변수 POPNOW_API_KEY에 넣어 두세요.
예제의 image_url, video_url에는 PopNow 샘플 파일이 들어 있습니다. 직접 가진 공개 HTTPS 링크, 업로드한 파일, 저장한 에셋으로 바꿔 쓰세요.
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "alibaba/wan-2.2-animate/character-animation",
"input": {
"prompt": "The person dances with relaxed, natural movement",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"resolution": "720p"
}
}'응답에는 taskId가 바로 들어 있습니다. 결과는 GET /api/v1/jobs/recordInfo로 가져오거나, callBackUrl을 넣어 알림을 받으세요.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"