소개
Wan 3.0 Pro Prime 텍스트→영상는 프롬프트로 2~30초 샷을 생성하고 오디오를 같은 파일에 담아 1080p, 2K, 4K로 전달합니다. 필드 목록은 Wan 3.0 Pro 텍스트→영상와 완전히 같지만 기반 렌더는 Wan 3.0 Prime이며, Alibaba는 Prime을 같은 능력을 갖춘 고속 버전으로 소개합니다. Prime의 네이티브 렌더는 1080p가 상한이므로 2k와 4k 단계는 네이티브로 렌더링한 것이 아니라 그 렌더를 확대한 것입니다.
시작 자료에 따라 모드 선택하기
| 시작 자료 | 모드 |
|---|---|
| 작성한 브리프가 장면, 행동, 카메라, 필요한 경우 사운드를 정합니다. | Wan 3.0 Pro Prime 텍스트→영상 |
| 승인된 시작 이미지가 피사체와 구성을 정하고, 지시문이 이후의 움직임을 이끕니다. | Wan 3.0 Pro Prime 이미지→영상 |
| 분리된 참조 자료에 정체성, 장소, 움직임 또는 사운드의 역할을 명확히 배정할 수 있습니다. | Wan 3.0 Pro Prime 레퍼런스→영상 |
핵심 기능 및 하이라이트
Wan 3.0 Pro와 같은 본문
필수 필드는 prompt(최대 20,000자) 하나이며, resolution의 기본값은 1080p, aspect_ratio는 adaptive, enable_prompt_expansion은 true입니다. 계약이 같으므로 JSON 본문 하나가 모델 이름만 바꾸면 Pro와 Pro Prime 모두에서 돌아갑니다. 프로젝트를 한쪽으로 정하기 전에 같은 시드로 테스트 샷을 양쪽에 보내 보십시오.
브리프에 적는 프레이밍
지하 납골당 예시는 프롬프트의 3분의 1을 프레이밍에만 씁니다. 머리 전체가 화면에 들어오고, 머리카락 위로 여백이 있고, 허리에서 프레임이 잘리고, 얼굴이 항상 보여야 한다는 내용입니다. 클로즈업에서 흔한 실패는 모델이 자기 프레임에서 얼굴을 잘라 내는 것이며, 프레이밍을 명시하는 것이 해결책입니다. 키 라이트는 촛불뿐이고, 흔들리는 불꽃과 멀리서 삐걱이는 철문 같은 오디오도 같은 과정에서 나옵니다.
머물 곳이 없는 움직임
수중 예시에는 기준이 될 바닥이 없습니다. 가라앉는 피사체를 따라 진홍색 실크 드레스가 꽃처럼 피어나고, 머리카락이 부채처럼 퍼지고, 손끝에서 거품이 이어지며, 카메라는 호를 그리면서 동시에 틸트합니다. 해상도를 지정하지 않았으므로 기본값 1080p로 실행됩니다. 아무것도 멈추지 않는 샷일수록 큰 전달 단계의 이점을 가장 많이 누립니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 피사체, 동작 하나, 카메라 무빙 하나, 그다음 빛과 소리 순서로 적으세요. 4K에서는 애매한 브리프가 실제로 돈이 되니, 분위기가 아니라 컷을 쓰세요. 1자 이상 · 20000자 이하 |
resolution | 아니요 | 1080p, 2k, 4k이고 기본은 1080p입니다. Wan 3.0 Prime의 네이티브 출력은 최대 1080p이므로 그 위 등급인 2k와 4k는 해당 크기로 네이티브 렌더링한 것이 아니라 그 렌더링을 키워서 전달합니다. |
aspect_ratio | 아니요 | 16:9, 4:3, 1:1, 3:4, 9:16 또는 auto입니다. 기본은 auto라 모델이 고르게 두고, 납품 형식이 정해져 있으면 비율을 지정하세요. |
duration_seconds | 아니요 | 2에서 30까지 정수 초라면 어떤 값이든 되고 기본은 5입니다. -1은 스마트 길이로, 모델이 길이를 정하며 최대치인 30초를 먼저 잡아 두고 실제로 나온 길이로 정산합니다. |
generate_audio | 아니요 | 기본으로 켜져 있습니다. 소리가 영상과 함께 생성돼 같은 파일 안에 도착합니다. 기본값: |
enable_prompt_expansion | 아니요 | 이 패밀리에서는 기본으로 켜져 있습니다. 얄팍한 브리프는 채워 주고 자세한 브리프는 다시 써 버리니, 프롬프트가 정밀한 컷 묘사가 되면 꺼 두세요. 기본값: |
seed | 아니요 | 0에서 2147483647까지입니다. 해상도나 길이를 조절하는 동안 고정해 두세요. |
요금
| 사양 | 요금 |
|---|---|
| $0.234 / 초 |
| $0.252 / 초 |
| $0.279 / 초 |
활용 사례
세로 프레임에서 움직이는 색 빛
오로라 예시는 얼어붙은 호수에서 담요 하나를 나눠 덮은 두 사람의 피부와 머리카락 위로 초록빛이 흐르는 모습을 9:16 프레임으로 요청합니다. 피부 위를 움직이는 색 빛은 밴딩과 색 노이즈가 가장 먼저 드러나는 곳이므로, 이런 피사체에 2K나 4K를 쓰는 것은 장면이 정말 필요로 할 때만으로 한정하십시오. 정지한 피사체를 4K로 만들면 파일만 커집니다.
핸드헬드, 자연광 장면
야간 페리 예시는 일부러 소박합니다. 핸드헬드 다큐멘터리식 프레이밍, 갑판 투광등과 멀리 보이는 항구 불빛, 선미 난간에서 이마를 맞대다가 흰 항적이 소용돌이치는 아래에서 키스하는 성인 남성 두 명입니다. 어떤 장면도 다른 프롬프트와 똑같이 보내므로 설정할 콘텐츠 플래그가 없습니다. 동의, 권리, 나이, 현지 법률에 대한 책임은 사용자에게 있습니다.
프롬프트 가이드 및 실전 팁
작게 탐색하고 크게 전달하기
seed를 고정하고 1080p, 5초에서 프롬프트를 다듬으십시오. 테이크가 정해지면 똑같은 본문을 resolution만 4k로 바꿔 다시 보냅니다. 해상도와 시드를 함께 바꾸면 두 가지를 동시에 바꾸는 셈이어서 무엇이 결과를 움직였는지 가려집니다.
확대된 파일에서는 하드 라이트부터 확인하기
밤의 단일 하드 광원, 즉 매달린 전구 하나나 갑판 조명 하나는 확대된 영상의 한계가 가장 먼저 드러나는 곳입니다. 감쇠 구간의 밴딩, 밀랍 같은 피부, 회색 얼룩이 되어 버린 젖은 천입니다. 그레이딩이나 시퀀스 편집에 들어가기 전에 전달된 2K나 4K 파일에서 그 부분을 확인하십시오.
최종 렌더 전에 문장을 확정하기
이 계열에서는 프롬프트 확장이 기본으로 켜져 있어 세밀한 브리프를 다시 씁니다. 프롬프트가 정확한 샷 묘사가 되면 enable_prompt_expansion을 꺼서 다듬은 버전이 그대로 실행되게 하십시오. 피사체, 동작 하나, 카메라 움직임 하나, 그다음 빛과 소리 순서로 씁니다.
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-3.0-pro-prime/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "1080p",
"aspect_ratio": "adaptive",
"duration_seconds": 5
}
}'
# 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 레퍼런스에서 확인하세요.



























