소개
Wan 2.6 텍스트→영상은 글로 쓴 한 장면이나 번호를 매긴 숏 리스트를 정확히 5초, 10초 또는 15초 길이의 720p 또는 1080p 클립으로 만듭니다. 필수 항목은 prompt 하나뿐입니다. 나머지는 모두 기본값이 있어 16:9, 720p, 5초, 끊김 없는 원테이크, 프롬프트 확장 꺼짐으로 시작합니다. 클립은 화면과 함께 생성된 사운드를 담아 돌아오며, audio_url로 녹음한 대사나 음악 큐를 넘기면 그 소리에 맞춰 움직이게 할 수도 있습니다.
시작 자료에 따라 모드 선택하기
| 처음에 가진 것 | 모드 |
|---|---|
| 글로 쓴 장면이나 대본 | Wan 2.6 텍스트→영상 |
| 승인된 시작 이미지 | Wan 2.6 이미지→영상 |
| 외형, 움직임, 소리를 따로 담은 참조 자료 | Wan 2.6 참조→영상 |
핵심 기능 및 하이라이트
두 해상도 모두에서 다섯 가지 화면비
aspect_ratio는 16:9, 9:16, 1:1, 4:3, 3:4를 받으며, 모든 비율을 720p와 1080p에서 쓸 수 있습니다. 입력 이미지에서 물려받는 것이 없으므로 필드 하나만 바꾸면 같은 브리프를 가로형 마스터와 세로형 숏폼으로 모두 렌더링할 수 있습니다. 해상도는 초당 요금과 작업 소요 시간을 정하기 때문에, 프롬프트를 다듬는 단계에서는 기본값인 720p가 가장 알맞습니다.
원테이크 또는 계획된 시퀀스
shot_type은 끊김 없는 원테이크인 single과, 같은 클립 안에서 모델이 여러 숏으로 컷을 나눌 수 있는 multi를 전환합니다. multi 요청은 enable_prompt_expansion 값과 상관없이 항상 프롬프트 확장을 켠 상태로 실행됩니다. 컷 분할이 브리프를 확장하는 과정에서 계획되기 때문입니다. 반전이 있는 짧은 이야기에는 multi가, 커버리지보다 연속성이 중요할 때는 single이 맞습니다.
같은 생성 과정에서 만들어지는 사운드
오디오는 화면과 함께 생성되므로, 프롬프트 끝에 소리에 관한 문장을 하나 넣으면 들리는 소리가 달라집니다. 이미 준비된 소리가 있다면 audio_url에 3~30초, 최대 15MB의 WAV 또는 MP3를 넘기면 되고, 입 모양과 동작의 속도가 그 파일에 맞춰집니다. 트랙이 더 길면 클립 길이에서 잘리고, 더 짧으면 클립의 나머지 부분은 무음이 됩니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 샷 그 자체입니다. 누가, 동작 하나, 카메라 움직임 하나, 그다음 빛과 소리를 적고, multi라면 번호 붙은 샷을 적습니다. 1자 이상 · 1500자 이하 |
negative_prompt | 아니요 | 빠져야 할 것을 적습니다. 자막, 로고, 불필요한 인물, 자꾸 나오는 색 같은 것들입니다. 500자 이하 |
aspect_ratio | 아니요 | 16:9, 9:16, 1:1, 4:3, 3:4 중 하나이며 기본값은 16:9입니다. 다섯 가지 모두 두 해상도에서 쓸 수 있습니다. |
resolution | 아니요 | 720p 또는 1080p이며 기본값은 720p입니다. 초당 단가와 처리 시간이 달라집니다. |
duration_seconds | 아니요 | 정확히 5, 10, 15 중 하나입니다. 다른 값은 반올림되지 않고 거절됩니다. |
audio_url | 아니요 | 클립이 따라갈 대사나 음악 큐입니다. 입 모양과 움직임의 속도가 이 파일에 맞춰집니다. |
shot_type | 아니요 | single은 한 테이크를 유지하고, multi는 모델이 여러 숏으로 나눕니다. 컷 구성은 프롬프트를 확장하면서 짜이므로 multi 요청에서는 enable_prompt_expansion이 자동으로 켜집니다. |
enable_prompt_expansion | 아니요 | 기본으로 꺼져 있습니다. 켜면 짧은 설명이 생성 전에 더 자세하게 다시 쓰입니다. 기본값: |
seed | 아니요 | 0에서 2147483647까지입니다. 변경 하나씩 비교할 때는 고정하고, 다양성이 필요하면 비워 두세요. |
요금
| 사양 | 요금 |
|---|---|
| $0.09 / 초 |
| $0.135 / 초 |
활용 사례
소리까지 글로 쓴 분위기 있는 원테이크
공개된 항구 예시는 원테이크의 전형을 보여 줍니다. 노란 방수복을 입은 어부가 젖은 밧줄을 감고, 지나가는 페리를 올려다보며 손을 듭니다. 카메라는 쌓인 나무 상자 뒤에서 천천히 움직이는 돌리 하나뿐입니다. 프롬프트가 오디오 문장으로 끝나기 때문에 꾸준한 빗소리, 길게 울리는 페리 경적, 삐걱이는 밧줄 소리가 별도 트랙 없이 화면 밑에 깔립니다. 설정은 16:9, 5초, 720p입니다.
소셜 피드용 세로형 마이크로 스토리
빵집 예시는 9:16, 10초, 1080p 클립 안에 번호를 매긴 숏 세 개를 요청합니다. 새벽에 올라가는 셔터, 반죽을 빚는 밀가루 묻은 손, 그리고 쟁반이 들어가며 주황빛으로 빛나는 오븐 문입니다. shot_type이 multi이므로 번호가 붙은 각 줄이 하나의 컷이 되고, 고정한 seed는 문구를 다듬는 동안 결과가 흔들리지 않게 잡아 줍니다.
촬영 전 룩 개발
아직 존재하지 않는 장면의 배경, 조명, 템포를 시험하는 데는 글로 쓴 브리프만으로 충분합니다. 다만 특정한 얼굴이나 제품을 실행마다 똑같이 유지하지는 못합니다. 인물이나 패키지를 알아볼 수 있게 남겨야 하는 순간이 오면 먼저 이미지를 만들고, 시작 이미지가 외형을 고정하는 이미지→영상으로 작업을 옮기십시오.
프롬프트 가이드 및 실전 팁
원테이크는 네 부분으로 쓰기
single에서는 피사체를 밝히고, 동작 하나와 카메라 움직임 하나를 지정한 다음, 조명과 소리에 관한 한 줄을 덧붙입니다. 항구 프롬프트가 바로 이 순서를 따르기 때문에 결과를 판단하기 쉽습니다. 돌리가 상자 뒤에 머무는 동안 밧줄, 시선, 드는 손이 모두 일어나는지만 보면 됩니다.
Late evening on a rain-soaked harbour quay. A fisherman in a yellow oilskin coils a wet rope, looks up at a passing ferry and raises a hand. Slow dolly from behind a stack of crates, sodium lights reflecting in the puddles. Audio: steady rain, a long ferry horn, the rope creaking.
multi에서는 숏에 번호 매기기
multi에서는 각 줄을 ‘Shot 1:’, ‘Shot 2:’처럼 시작하고, 줄마다 고유한 프레이밍과 피사체를 정합니다. 한 줄에는 사건 하나만 씁니다. 한 줄에 사건을 두 개 쓰는 순간 컷의 경계를 직접 정할 수 없게 됩니다. 멀티숏 편집에는 긴 길이가 필요하므로 10초나 15초를 고르십시오.
제외할 것은 본 브리프 밖으로
자막, 로고, 불필요한 인물, 자꾸 나타나는 색은 최대 500자인 negative_prompt에 넣고, 프롬프트 자체는 1,500자 미만으로 유지합니다. 원테이크에서는 프롬프트가 이미 정확한 숏 묘사라면 enable_prompt_expansion을 끈 채로 두고, 한 줄짜리 아이디어를 살을 붙여 키워야 할 때 켭니다.
한 번에 하나만 바꿔 비교하기
seed는 0~2147483647을 받습니다. 카메라 움직임, 화면비, single과 multi처럼 한 가지만 바꾸는 동안에는 고정하고, 다양한 결과를 원할 때는 생략합니다. 비교를 안정시켜 주지만 프레임 단위로 똑같은 재생성을 약속하지는 않습니다. 5초, 10초, 15초 이외의 길이는 반올림되지 않고 거부됩니다.
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-2.6/text-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"shot_type": "single"
}
}'
# 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 레퍼런스에서 확인하세요.
