소개
Wan 3.0 Pro 텍스트→영상는 프롬프트로 샷을 쓰고 1080p, 2K, 4K에서 2~30초 클립으로 전달하며, 생성 오디오도 같은 파일에 담습니다. 필수 필드는 prompt 하나이고 최대 20,000자까지 받습니다. Wan 3.0의 네이티브 렌더는 1080p가 상한이므로 2k와 4k 단계는 그 렌더를 확대한 것이지 그 크기로 새로 그린 것이 아닙니다. 이 엔드포인트에는 480p와 720p 단계가 없으며, 그 크기는 Wan 3.0이 맡습니다.
시작 자료에 따라 모드 선택하기
| 시작 자료 | 모드 |
|---|---|
| 작성한 브리프가 장면, 행동, 카메라, 필요한 경우 사운드를 정합니다. | Wan 3.0 Pro 텍스트→영상 |
| 승인된 시작 이미지가 피사체와 구성을 정하고, 지시문이 이후의 움직임을 이끕니다. | Wan 3.0 Pro 이미지→영상 |
| 분리된 참조 자료에 정체성, 장소, 움직임 또는 사운드의 역할을 명확히 배정할 수 있습니다. | Wan 3.0 Pro 레퍼런스→영상 |
핵심 기능 및 하이라이트
네이티브 렌더 하나에서 나오는 세 가지 전달 크기
resolution은 1080p(기본값), 2k, 4k 중에서 고릅니다. 큰 두 단계는 모델이 그린 것을 늘리는 것일 뿐 더 그려 넣지 않으므로 크롭, 트래킹, 영사를 전제로 한 영상에 알맞고, 품질은 원래 렌더를 넘지 못합니다. 먼저 1080p에서 샷을 정하고 4K는 전달 단계로 다루십시오.
프롬프트 확장은 처음부터 켜져 있습니다
이 계열에서는 enable_prompt_expansion의 기본값이 true입니다. 빈약한 브리프를 채워 주므로 스케치 단계에서는 편리하지만, 세밀한 브리프는 다시 씁니다. 프롬프트가 정확한 샷 묘사가 되면 false로 바꿔 다듬은 문장이 그대로 실행되게 하십시오.
지정하지 않으면 프레임은 적응형
aspect_ratio의 기본값은 adaptive이며 모델이 프레임을 고릅니다. 전달 포맷이 정해져 있다면 16:9, 4:3, 1:1, 3:4, 9:16 중 하나를 지정하십시오. 펜스 예시는 세로 화면용 9:16을 요청했고, 향수, 흑백, 타투 예시는 모두 16:9로 고정했습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 피사체, 동작 하나, 카메라 무빙 하나, 그다음 빛과 소리 순서로 쓰세요. 4K에서는 애매한 브리프가 실제로 돈이 되니, 분위기가 아니라 컷을 쓰세요. 1자 이상 · 20000자 이하 |
resolution | 아니요 | 1080p, 2k, 4k이고 기본은 1080p입니다. Wan 3.0의 네이티브 출력은 최대 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.144 / 초 |
| $0.16 / 초 |
| $0.184 / 초 |
활용 사례
강한 빛 아래의 향수·뷰티 광고
향수 예시는 5초짜리 슬로 모션 광고입니다. 등이 파인 검은 드레스를 입은 성인 여성이 비가 들이치는 창에서 돌아서고, 단단한 키 라이트 하나가 등줄기를 타고 흐르며 머리카락에서 물방울이 튀고, 사운드트랙에는 낮은 첼로 음과 빗소리가 깔립니다. 광택 있는 원단, 단일 하드 광원, 작고 빠른 입자는 영상을 확대할 때 가장 먼저 무너지는 요소이므로 2K나 4K 결과물에서는 바로 그 부분을 확인하십시오.
하나의 외부 힘으로 움직이는 천
두 예시는 옷이 어떻게 놓여 있는지 묘사하는 대신 하나의 힘으로 옷을 움직입니다. 흑백 패션 필름에서는 산업용 송풍기 앞에서 3미터 길이의 실크 시폰이 몸을 휘감고, 검은 배경 앞 하드 키 라이트 속에서 한쪽 어깨를 감아 돕니다. 펜스 예시에서는 착륙하는 비행기의 제트 후류가 두 사람의 옷을 몸에 납작하게 붙입니다. 힘을 명시하면 천이 따라야 할 원인이 생깁니다.
프롬프트 가이드 및 실전 팁
1080p에서 찾고, 고른 시드로 다시 렌더링하기
seed를 고정한 채 5초, 1080p에서 샷을 찾고 다시 돌릴 때마다 필드 하나만 바꾸십시오. 그다음에야 같은 프롬프트와 시드로 resolution을 4k로 바꿔 보냅니다. 해상도와 문장을 한 번에 바꾸면 무엇이 결과를 움직였는지 알 수 없습니다.
분위기가 아니라 샷을 쓰기
피사체, 동작 하나, 카메라 움직임 하나, 그다음 빛과 소리입니다. 타투 숍 프롬프트가 좋은 본보기입니다. 빛은 촛불과 책상 램프 하나뿐이고, 장갑 낀 손이 갈비뼈 위 도안에 음영을 넣고, 찡그림과 느린 숨, 어깨 너머의 웃음, 윙윙대는 기계 소리, 아주 느린 푸시 인이 이어집니다. 4K에서 모호한 브리프를 보내는 것은 자기 의도를 확인하는 방법으로는 비싼 편입니다.
듣고 싶은 소리를 이름으로 적기
소리는 화면과 함께 생성되므로 소리의 출처를 나열하십시오. 향수 광고는 ‘low cello note and rain’을, 송풍기 필름은 ‘the roar of the fan and snapping cloth’를 요청합니다. 작곡가가 음악을 붙일 때는 generate_audio를 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-pro/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 레퍼런스에서 확인하세요.



























