Wan 2.2 Animate는 캐릭터 이미지와 동작을 제공하는 원본 영상을 결합합니다. AKOOL의 Character Swap API 문서에서 이미지는 외형을 안내하고 원본 MP4는 연기를 제공합니다. API 응답 예시의 기반 모델은 wavespeed-ai/wan-2.2/animate입니다.
AKOOL은 Character Swap API로 이 기능을 제공합니다. AI 동영상 도구 목록에서 일반 텍스트 동영상 생성 모델을 선택하는 것과는 다릅니다.
핵심 요약
- 외형은 이미지에서: PNG 또는 JPEG 캐릭터 이미지를 업로드하세요.
- 동작은 영상에서: 전달할 연기가 담긴 MP4를 제공하세요.
- Animate와 replace는 다른 API 모드입니다:
animate는 캐릭터 이미지에 동작을 전달하고,replace는 엔드포인트에 명시된 얼굴 교체를 수행합니다. - 작업 ID 저장: 생성은 비동기이므로 반환된
_id로 상태를 확인하고 7일 유효한 URL이 만료되기 전에 결과를 다운로드하세요.
목차
- Wan Animate란 무엇인가요?
- animate와 replace 모드는 어떻게 다른가요?
- 모션 참조 영상은 어떻게 준비하나요?
- AKOOL에서 Wan Animate API를 어떻게 사용하나요?
- 캐릭터 애니메이션에 어떤 프롬프트가 도움이 되나요?
- AI 캐릭터 모션 전송이 실패하는 이유는 무엇인가요?
- 결과를 어떻게 검토하고 저장하나요?
- 자주 묻는 질문
Wan Animate란 무엇인가요?
Wan Animate는 참조 기반 캐릭터 애니메이션 과정입니다. 이미지 하나가 외형을 정하고 원본 영상이 적용할 동작을 제공합니다. AKOOL Character Swap API의 animate 모드는 두 입력을 결합하며, 짧은 텍스트 프롬프트로 결과를 추가 안내할 수 있습니다.
세 가지 자료로 이해하면 쉽습니다.
| Input/output | Role |
|---|---|
| Character image | Defines the character you want to animate |
| Motion reference video | Supplies timing, body motion, and performance |
| Generated video | Combines the character appearance with the referenced motion |
AKOOL 생성 엔드포인트는 PNG 또는 JPEG 캐릭터 이미지 URL과 MP4 원본 영상 URL을 요구합니다. API 응답 예시의 모델은 wavespeed-ai/wan-2.2/animate이므로 이 이름은 API 맥락에서 근거가 있습니다. 공개 웹사이트에 같은 이름의 메뉴가 있다는 뜻은 아닙니다.
animate와 replace 모드는 어떻게 다른가요?
AKOOL 문서의 엔드포인트에서 animate는 원본 영상의 동작을 캐릭터 이미지에 적용합니다. replace는 제공된 이미지로 원본 영상의 얼굴을 교체하는 별도 모드입니다. 이 정의는 해당 AKOOL API에 적용되며 Wan 모델군을 쓰는 모든 제품의 정의는 아닙니다.
| Mode | Goal | Required inputs | What to review |
|---|---|---|---|
animate | Animate the supplied character using source-video motion | Character image + motion MP4 | Identity, body motion, clothing, hands, feet |
replace | Replace faces in the source video with the supplied character | Character image + source MP4 | Face match, tracking, pose changes, occlusion |
모드를 지정하지 않으면 기본값은 animate입니다.
animate와 replace는 서로 다른 변환이므로 구분해야 합니다. 전체 AI 캐릭터 모션 전송이 목표라면 animate로 시작하세요.
Kling 기반의 별도 제작 과정은 모션 제어 캐릭터 교체 가이드를 참고하세요. Kling 2.6도 이미지와 참조 연기를 결합하지만 모델과 작업 방식은 다릅니다.
모션 참조 영상은 어떻게 준비하나요?
캐릭터 이미지와 구도 및 신체 노출 범위가 맞는 선명한 원본 연기를 사용하세요. 참조가 명확할수록 문제가 원본 자료 때문인지 생성 때문인지 판단하기 쉽습니다.
구도 맞추기
모션 영상이 전신 보행을 보여 준다면 캐릭터 이미지도 충분한 전신 정보를 제공해야 합니다.
얼굴 중심 사진을 달리기, 춤, 큰 다리 동작과 조합하면 모델이 이미지에 없는 신체 구조를 만들어야 합니다.
참조 기반 영상 일관성을 높이려면 AKOOL은 선명한 피사체, 보이는 정체성 세부 요소, 보존할 요소를 명시하는 참조 자료를 권장합니다.
연기자가 계속 보이게 하기
연기자가 화면 안에 머무는 모션 참조를 선택하세요.
다음과 같은 원본은 피하세요.
- 발이 반복해서 화면 밖으로 나감,
- 손이 몸 뒤로 사라짐,
- 다른 사람이 피사체를 가림,
- 카메라 구도가 갑자기 바뀜,
- 연기자가 너무 작아짐.
가림 줄이기
교차한 팔, 숨은 손, 몸통을 가리는 소품, 빠른 회전은 연기 전송 결과 검토를 어렵게 합니다.
더 좋은 참조: 전신이 보이고 동작이 적당하며 카메라가 안정적입니다.
어려운 참조: 잘린 발, 반복 회전, 소품 뒤에 숨은 손, 여러 컷 전환이 있습니다.
AKOOL에서 Wan Animate API를 어떻게 사용하나요?
캐릭터 이미지 URL과 원본 MP4 URL을 AKOOL Character Swap 생성 엔드포인트에 보내고 mode를 animate로 설정하세요. 선택적으로 프롬프트를 추가한 뒤 반환된 _id를 저장하세요. 결과 엔드포인트에서 해당 식별자를 사용해 completed 상태까지 확인합니다.
문서의 생성 엔드포인트는 다음과 같습니다.
POST https://openapi.akool.com/api/open/v4/characterSwap/create
AKOOL은 x-api-key 헤더 또는 Bearer 인증을 허용합니다.
현재 인증 및 엔드포인트 정보는 공식 Character Swap API 안내를 참고하세요.
민감 정보를 숨긴 요청 예시
curl --location 'https://openapi.akool.com/api/open/v4/characterSwap/create' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"image": "https://example.com/approved-character.png",
"video": "https://example.com/reference-motion.mp4",
"resolution": "720p",
"mode": "animate",
"prompt": "Follow the reference performance with smooth motion. Keep the character appearance and clothing consistent."
}'
주요 필드는 다음과 같습니다.
| Field | Purpose |
|---|---|
image | PNG/JPEG character-image URL |
video | MP4 motion-reference URL |
duration | Optional, 1 to 120 seconds; otherwise detected from source |
resolution | 480p, 720p, or 1080p |
mode | animate or replace |
prompt | Optional guidance, maximum 500 characters |
webhookurl | Optional completion callback |
이 값들은 해당 엔드포인트의 문서화된 매개변수이며 모든 플랫폼에 공통인 Wan 제한이 아닙니다. 응답의 _id를 저장하세요.
작업 확인:
GET https://openapi.akool.com/api/open/v3/content/video/infobymodelid?video_model_id=YOUR_TASK_ID
작업 상태는 다음과 같습니다.
1: 대기2: 처리 중3: 완료4: 실패
상태가 3이면 생성 URL이 video 필드에 표시됩니다.
캐릭터 애니메이션에 어떤 프롬프트가 도움이 되나요?
텍스트는 연기의 원천이 아니라 안내로 취급하세요. 실제 동작은 모션 참조가 정해야 합니다. 프롬프트는 정체성, 구도, 단순함을 강화하고 원본과 충돌하는 움직임을 요구하지 않아야 합니다.
1. 간단한 제스처
참조 영상의 느린 인사 제스처를 제공된 캐릭터에 적용하세요. 의상과 머리를 유지하고 부드럽게 움직이세요.
2. 발표자
참조 연기자의 손동작과 속도를 따르세요. 캐릭터가 카메라를 바라보게 하고 추가 제스처는 피하세요.
3. 걷기
제공된 보행 주기를 따르세요. 캐릭터의 신체 비율과 의상을 유지하고 두 발이 보이게 하세요.
4. 스타일화된 캐릭터
참조 타이밍으로 제공된 일러스트 캐릭터를 움직이세요. 평면 색상과 그린 윤곽선을 유지하세요.
5. 수정 프롬프트
같은 캐릭터와 더 느리고 잘리지 않은 참조 영상을 사용하세요. 동작을 단순하게 하고 전신을 화면 안에 유지하세요.
이 예시는 만능 문법이 아닙니다. 영상이 이미 제공하는 연기의 범위를 선택적으로 제한하는 지침입니다.
AI 캐릭터 모션 전송이 실패하는 이유는 무엇인가요?
눈에 띄는 실패는 대개 입력 불일치 또는 이미지에 없는 정보를 재구성해야 하는 동작에서 발생합니다. 프롬프트를 늘리기 전에 원본 쌍을 수정하세요.
| Symptom | Likely cause | First correction |
|---|---|---|
| Feet deform or disappear | Feet cropped in image/reference | Use full-body inputs |
| Hands look unstable | Hands hidden or crossing | Choose clearer hand motion |
| Body proportions drift | Image and performer builds differ strongly | Use a closer body/proportion match |
| Fast turn breaks identity | Large rotation or face occlusion | Slow the reference movement |
| Background shifts | Reference camera/background changes | Use a steadier source clip |
| Illustrated style softens | Motion reconstruction changes edges/textures | Simplify motion and inspect style drift |
모션 참조는 추측을 줄이지만 완벽한 캐릭터 보존을 보장하지는 않습니다. 입력 준비가 프롬프트만큼 중요한 이유입니다.
결과를 어떻게 검토하고 저장하나요?
API 작업 완료는 생성이 끝났다는 의미이며 시각적 품질을 통과했다는 뜻은 아닙니다. 채택 전에 처음, 중간, 끝을 검토하세요.
확인 항목:
- 얼굴: 같은 인물로 알아볼 수 있나요?
- 손: 제스처나 교차 동작에서도 손가락이 유지되나요?
- 발: 보행이나 전신 동작에서 두 발이 안정적인가요?
- 의상: 색, 무늬, 실루엣이 일관적인가요?
- 배경: 동작과 자연스럽게 이어지나요?
AKOOL 결과 엔드포인트는 실제 길이, 해상도, 차감 크레딧, 최종 영상 URL과 해당 시 실패 이유를 반환합니다.
생성 자료는 7일 동안 유효하므로 승인된 결과를 신속하게 다운로드하고 보관하세요.
과정 체험하기
이 API 이외의 다양한 생성 옵션이 필요하다면 AKOOL의 AI 동영상 도구를 살펴보세요.
다른 참조 기반 접근은 모션 제어 캐릭터 교체를 읽어 보세요. 관련 클립 간 캐릭터와 외형 유지 방법은 참조 기반 영상 일관성을 참고하세요.
