소개
Wan 3.0 Prime 텍스트→영상는 글로 쓴 프롬프트만으로 소리가 포함된 2~30초 클립을 생성합니다. 필드는 Wan 3.0 텍스트→영상와 완전히 같습니다. prompt는 필수이고 duration_seconds, resolution(480p, 720p, 1080p, 기본값 720p), aspect_ratio(기본값 16:9), generate_audio, enable_prompt_expansion, seed는 선택입니다. 따라서 기존 Wan 3.0 요청은 모델 이름만 바꾸면 여기서 그대로 동작합니다. Alibaba는 Prime을 같은 능력을 갖춘 Wan 3.0의 고속 버전으로 소개합니다.
시작 자료에 따라 모드 선택하기
| 시작 자료 | 모드 |
|---|---|
| 작성한 브리프가 장면, 행동, 카메라, 필요한 경우 사운드를 정합니다. | Wan 3.0 Prime 텍스트→영상 |
| 승인된 시작 이미지가 피사체와 구성을 정하고, 지시문이 이후의 움직임을 이끕니다. | Wan 3.0 Prime 이미지→영상 |
| 분리된 참조 자료에 정체성, 장소, 움직임 또는 사운드의 역할을 명확히 배정할 수 있습니다. | Wan 3.0 Prime 레퍼런스→영상 |
핵심 기능 및 하이라이트
그대로 바꿔 끼우는 요청, 더 빠른 처리
스키마, 기본값, 열거값이 모두 같으므로 Wan 3.0과 Prime 사이에서 작업을 옮기는 것은 단어 하나를 바꾸는 일입니다. 마감이 있는 작업은 여기로 보내고, 처리 속도보다 초당 가격이 중요한 작업은 Wan 3.0에 두십시오. 두 모델에서 시드를 고정하면 두 파일을 바로 비교할 수 있습니다.
연속성을 확인할 수 있는 긴 테이크
등대 예시는 720p, 오디오 포함으로 10초입니다. 회전하는 빛이 몇 초마다 두 사람을 훑고 지나가며 그 사이에는 어둠 속에 남겨 두고, 사운드트랙에는 무적 소리와 바다가 깔립니다. 주기적인 피사체는 긴 클립이 끊김 없이 이어지는지, 아니면 조용히 리셋되는지 가려내는 정직한 테스트입니다.
역광, 얇은 천, 바람
옥상 예시는 720p에서 5초입니다. 골든 아워의 지중해 옥상 난간에서 여성 뒤로 얇은 리넨 셔츠가 들리고, 카메라가 천천히 돌며, 따뜻한 역광과 렌즈 번짐, 바닷바람과 갈매기 소리가 이어집니다. 역광 속 얇은 천과 흩날리는 머리카락은 까다로운 피사체이므로 직접 렌더링한 결과에서도 꼼꼼히 확인할 가치가 있습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 컷 자체를 적으세요. 피사체, 동작 하나, 카메라 무빙 하나, 그다음 빛과 소리 순서입니다. 1자 이상 |
aspect_ratio | 아니요 | 16:9, 9:16, 1:1, 4:3, 3:4, adaptive 중에서 고릅니다. adaptive는 모델이 고르게 두는 값입니다. |
enable_thinking | 아니요 | 생성 전에 모델이 요청과 참고 자료를 충분히 검토하게 합니다. 분량이 많은 문서, 웹 페이지, 복잡한 참고 이미지에 도움이 되지만 처리 시간이 길어집니다. 기본값: |
resolution | 아니요 | 480p, 720p, 1080p 중에서 고릅니다. 기본은 720p입니다. |
duration_seconds | 아니요 | 2에서 30까지 정수 초라면 어떤 값이든 되고, -1이면 스마트 길이입니다. 스마트 길이는 모델이 길이를 정하며, 최대치인 30초를 먼저 잡아 두고 실제로 나온 길이로 정산합니다. |
generate_audio | 아니요 | 기본으로 켜져 있습니다. 소리가 화면과 이미 맞물린 채로 클립이 돌아옵니다. 기본값: |
enable_prompt_expansion | 아니요 | 기본은 꺼짐입니다. 켜면 생성 전에 프롬프트를 다시 쓰는데, 얄팍한 브리프에는 도움이 되고 자세한 브리프와는 다툽니다. 기본값: |
seed | 아니요 | 0에서 2147483647까지입니다. 필드 하나씩 바꿔 비교하려면 고정하고, 다양성을 원하면 빼세요. |
요금
| 사양 | 요금 |
|---|---|
| $0.0612 / 초 |
| $0.126 / 초 |
| $0.252 / 초 |
활용 사례
일관성이 필요한 초현실적 장면
소금 사막 예시는 하늘과 땅의 경계가 보이지 않는 거울 같은 수면, 카메라 쪽으로 걸어오는 여성과 그 아래에서 거꾸로 걷는 반영, 그녀가 한 바퀴 돌 때 수면에 퍼지는 물결을 요청합니다. 프레임은 처음에 고정되어 있다가 나중에야 천천히 다가가므로 검토할 대상으로 반영만 뚜렷이 남습니다.
목소리까지 같은 과정에서 만드는 퍼포먼스
녹음 부스 예시에서는 가수가 리본 마이크 앞에서 길고 낮은 음을 끌다가 한쪽 이어컵을 벗고 컨트롤룸 유리 너머로 미소 짓습니다. 마이크 망에서 얼굴로 넘어가는 랙 포커스도 프롬프트에 적혀 있습니다. 목소리는 화면과 같은 과정에서 생성되므로 둘 다 파일 하나로 돌아옵니다.
프롬프트 가이드 및 실전 팁
카메라 변화는 사건으로 쓰기
샷 중간에 카메라가 무언가를 할 때는 순서가 있는 사건으로 쓰십시오. 부스 프롬프트는 ‘rack focus from the microphone mesh to her face’, 소금 사막 프롬프트는 ‘wide static frame that then pushes slowly in’이라고 적습니다. 비트마다 카메라 지시를 하나씩만 두면 결과를 검토하기 쉽습니다.
긴 클립에는 리듬을 주기
5초보다 긴 클립에는 반복되거나 진행되는 무언가, 예를 들어 몇 초마다 지나가는 빛, 밀물, 사람으로 차오르는 방을 주어 연속성을 판단할 수 있게 하십시오. 길이는 2~30 사이의 정수 초이며, -1을 넣으면 모델이 고릅니다. 먼저 5초에서 모습을 확정하십시오.
시드를 고정하고 Prime과 Wan 3.0 비교하기
같은 seed로 본문 하나를 두 모델에 보내고, 그다음 한 번에 필드 하나씩만 바꾸십시오. 시드를 고정하면 비교는 공정해지지만 같은 프레임이 보장되지는 않습니다. 세밀한 프롬프트에는 enable_prompt_expansion을 기본값 false로 두고, 두 줄짜리 빈약한 아이디어일 때만 켜십시오.
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-prime/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "16:9",
"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 레퍼런스에서 확인하세요.
