요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
aspect_ratio | 아니요 | 화면 모양: 가로, 정사각형, 세로. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 기본값: 16:9 |
duration_seconds | 아니요 | 클립 길이. 초 단위로 요금이 붙습니다. ≥ 2 · ≤ 10 · 기본값: 5 |
negative_prompt | 아니요 | 나오지 않았으면 하는 것. |
prompt | 예 | Describe the new scene: what each reference clip contributes, then setting, action, camera and light. |
reference_image_urls | 아니요 | 결과에 그대로 남길 인물, 의상, 장소의 참조 이미지. |
reference_video_urls | 아니요 | 움직임, 카메라, 스타일을 따라 할 참조 영상. |
resolution | 아니요 | 출력 크기. 클수록 선명하고 가격도 올라갑니다. 720p · 1080p · 기본값: 720p |
seed | 아니요 | 같은 숫자를 쓰면 같은 결과를 다시 얻을 수 있습니다. ≥ 0 · ≤ 2147483647 |
shot_type | 아니요 | Single continuous shot, or a multi-shot edit. single · multi · 기본값: single |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /초 | ≈ USD |
|---|---|---|
| resolution 720p | 9.75 | US$0.098 |
| resolution 1080p | 14.62 | US$0.15 |
작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 49크레딧/ 5초 영상(US$0.49)입니다.
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Wan 2.6 API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 alibaba/wan-2.6/reference-to-video, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
- 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
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: $IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/wan-2.6/reference-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_video_urls": [
"https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4"
],
"aspect_ratio": "16:9",
"resolution": "720p",
"duration_seconds": 5,
"shot_type": "single"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.
Wan 2.6 API 질문
Wan 2.6 API 요금은 얼마인가요?
Wan 2.6 가격은 가장 저렴한 레퍼런스로 영상 만들기 기준 49크레딧(US$0.49) / 5초 영상부터입니다. 옵션별 가격: 720p 9.75크레딧/초, 1080p 14.62크레딧/초. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 Wan 2.6의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 동영상 만들기: alibaba/wan-2.6/text-to-video; 이미지로 영상 만들기: alibaba/wan-2.6/image-to-video; 레퍼런스로 영상 만들기: alibaba/wan-2.6/reference-to-video을(를) 넣으세요.
멀티숏은 무엇을 하나요?
shot_type을 multi로 두면 한 클립 안에서 여러 숏으로 끊길 수 있습니다. 프롬프트를 번호 붙인 숏으로 쓰고 각 컷에 이유를 주세요. 연결이 더 중요하면 single을 쓰면 됩니다. 컷 구성은 프롬프트를 확장하면서 짜이므로 multi 요청에서는 프롬프트 확장이 켜집니다.
레퍼런스 영상이나 이미지 여러 장을 보낼 수 있나요?
보낼 수 있습니다. 레퍼런스 → 영상은 참조 영상을 최대 세 개, 스틸 이미지를 최대 두 장(합쳐 최대 다섯 개) 받아 거기에 담긴 대상을 직접 쓴 장면으로 옮깁니다. 스틸 한 장을 첫 프레임으로 움직이려면 이미지→영상을 쓰세요.
aspect_ratio 필드가 있나요?
텍스트→영상과 레퍼런스 → 영상에는 있습니다. 16:9, 9:16, 1:1, 4:3, 3:4를 두 해상도 모두에서 고를 수 있습니다. 이미지→영상은 보낸 프레임의 비율을 유지하므로 그 호출 전에 잘라 두세요.
Wan 2.6에서 무엇이 달라졌나요?
멀티숏 편집, 720p·1080p에서의 15초 클립, 그리고 화면과 함께 생성되는 오디오입니다.
Wan 2.6 API의 제한은 무엇인가요?
영상 길이: 2–10 s; 해상도: 720p · 1080p; 화면 비율: 16:9 · 9:16 · 1:1 · 4:3 · 3:4; 참조 이미지: 2; 참조 영상: 3. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 Wan 2.6을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Wan 2.6을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.
모든 Wan 모델
Wan 2.6 Flash는 같은 요청을 더 저렴하게 처리하고 세부 묘사는 조금 덜해요. Wan 3.0은 최대 30초의 더 긴 클립을 지원해요.
- Wan 3.0 API오디오가 맞춰진 최대 30초 클립34크레딧부터 / 5초 영상
- Wan 3.0 Prime API더 빠른 Wan 3.0, 오디오 포함 최대 30초46크레딧부터 / 5초 영상
- Wan 3.0 Pro Prime API더 빠른 Wan 3.0 Pro, 2K·4K 출력176크레딧부터 / 5초 영상
- Wan 3.0 Pro API1080p·2K·4K의 Wan 3.0, 최대 30초108크레딧부터 / 5초 영상
- Wan 2.7 Pro API4K 대형 캔버스와 최대 9장 합성12크레딧부터 /장
- Wan 2.7 API구도를 먼저 고민한 뒤 최대 4장을 그려요5크레딧부터 /장
- Wan 2.6 Flash API이미지 한 장으로 빠르게 만드는 멀티숏 클립17크레딧부터 / 5초 영상
- Wan 2.6 API사운드가 있는 멀티숏 시퀀스, 최대 1080p49크레딧부터 / 5초 영상
- Wan 2.5 API내 오디오에 맞출 수 있는 1080p 사운드 클립34크레딧부터 / 5초 영상
- Wan 2.2 Animate API레퍼런스 영상으로 캐릭터 사진을 움직여요7.95크레딧부터 /초
- Wan 2.2 LoRA APIWan 2.2 영상, 두 전문가 단계 어디에나 LoRA 적용18크레딧부터 / 5초 영상
- Wan 2.2 API480p 또는 720p의 간단한 5초 클립36크레딧부터 /회
- Wan 2.2 5B LoRA API가벼운 720p Wan 2.2 클립, 내 LoRA 불러오기18크레딧부터 /회
- Wan 2.2 Image LoRA APIWan 2.2 스틸, 슬롯 3개에 LoRA 최대 9개5크레딧부터 /장
- Wan 2.1 LoRA APIWan 2.1 영상 생성과 편집, 내 LoRA와 카메라 무빙까지36크레딧부터 /회
- Wan 2.1 Image LoRA API사진 같은 Wan 2.1 스틸과 스타일 변경, 내 LoRA 사용5크레딧부터 /장

