소개
Wan 2.2 텍스트→영상은 글로 쓴 프롬프트만으로 클립을 생성합니다. 요청 한 번마다 16:9 또는 9:16 비율, 480p 또는 720p 해상도의 무음 5초 영상 한 편이 반환됩니다. 프롬프트는 최대 5,000자이며 필수 항목은 이것 하나뿐입니다. 화면비 기본값은 16:9, 해상도 기본값은 480p이고, 프롬프트 확장은 직접 켜지 않는 한 꺼져 있습니다.
가진 소재에 맞춰 Wan 2.2 모드 고르기
| 처음 가진 것 | 모드 | 요청에 필요한 것 |
|---|---|---|
| 글로 쓴 장면이나 대본 | Wan 2.2 텍스트→영상 | 프롬프트, 16:9 또는 9:16 |
| 그대로 살리고 싶은 스틸 이미지 | Wan 2.2 이미지→영상 | 이미지와 프롬프트, 화면비는 이미지가 결정 |
핵심 기능 및 하이라이트
5초로 고정된 테이크
텍스트→영상에는 길이 설정이 없어 모든 테이크가 정확히 5초입니다. 그래서 요청을 보내기 전에 결과물의 길이를 알 수 있습니다. 5초에 담기는 것은 피사체 하나, 동작 하나, 카메라 움직임 하나로 이루어진 한 비트이지 여러 사건이 이어지는 흐름이 아니므로, 프롬프트도 그 분량에 맞춰 쓸 때 결과가 가장 좋습니다.
두 가지 화면비와 두 가지 해상도
화면비는 기본값인 16:9와 세로형 배포용 9:16 중에서 고릅니다. 정사각형과 4:3은 제공되지 않으므로, 정사각형으로 납품해야 한다면 16:9로 생성한 뒤 편집에서 잘라 내십시오. 해상도는 480p와 720p이며 가격을 바꾸는 설정은 이것 하나뿐이라, 초안 단계에서는 480p를 쓰는 것이 자연스럽습니다.
영상만 출력
클립에는 오디오 트랙이 없고 오디오 설정도 없습니다. 보는 사람이 느껴야 할 것은 모두 화면에 보여야 합니다. 공개된 눈 내리는 승강장 예시는 앰비언스에 기대는 대신 내리는 눈, 추위에 하얗게 번지는 입김, 깜빡이는 승강장 조명으로 리듬을 만듭니다.
선택 사항인 프롬프트 확장과 시드
프롬프트 확장을 켜면 짧은 지시문이 생성 전에 더 자세한 내용으로 다시 쓰입니다. 시드는 0부터 2147483647까지 지정할 수 있으며, 난수원을 고정해 한 번에 한 가지씩 바꿔 가며 비교하게 해 줍니다. 다만 다시 실행했을 때 프레임 단위까지 같은 클립이 나온다고 보장하지는 않습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 샷 자체를 최대 5,000자로 씁니다. 누가, 동작 하나, 카메라 움직임 하나, 그리고 빛을 적습니다. 1자 이상 · 5000자 이하 |
aspect_ratio | 아니요 | 16:9 또는 9:16이며 기본값은 16:9입니다. 이 엔드포인트에는 정사각형과 4:3이 없습니다. |
resolution | 아니요 | 480p 또는 720p이며 기본값은 480p입니다. 가격을 바꾸는 설정은 이것 하나뿐입니다. |
enable_prompt_expansion | 아니요 | 기본으로 꺼져 있습니다. 켜면 짧은 지시가 생성 전에 더 자세한 지시로 다시 쓰입니다. 기본값: |
seed | 아니요 | 0에서 2147483647까지입니다. 한 번에 한 가지만 바꿔 비교할 때는 고정하고, 다양한 결과를 원하면 비워 두세요. |
요금
요청 한 번에 5초짜리 클립 하나가 반환됩니다.
| 사양 | 요금 |
|---|---|
| $0.24 / 요청 |
| $0.48 / 요청 |
활용 사례
스토리보드 초안을 한꺼번에
스토리보드의 비트마다 프롬프트를 하나씩 쓰고 목록 전체를 480p로 렌더링합니다. 5초면 프레이밍과 움직임을 판단하기에 충분합니다. 모든 요청의 길이가 같고 가격은 해상도로만 정해지므로, 배치를 제출하기 전에 전체 비용을 알 수 있습니다. 채택한 테이크는 같은 프롬프트와 시드로 720p에서 다시 렌더링하십시오.
소셜 피드용 세로 클립
화면비를 9:16으로 설정하고 이어지는 동작 하나를 묘사합니다. 공개된 야시장 예시가 바로 그렇게 720p로 만든 것입니다. 노란 우비를 입은 젊은 여성이 꼬치 노점에서 꼬치를 받아 들고, 줄지어 걸린 전구 사이로 연기와 김이 피어오르며, 그녀가 돌아서서 카메라 쪽으로 걸어오는 동안 카메라는 핸드헬드로 천천히 다가갑니다.
샷 아이디어가 움직임으로 성립하는지 확인
720p 테이크로 넘어가기 전에 아이디어를 저렴하게 시험할 수 있습니다. 등대 계단 예시는 랜턴을 든 노인이 나선 계단의 마지막 굽이를 오르고 낮은 카메라가 그를 따라가는, 동작 하나와 카메라 위치 하나로만 쓰였고 16:9, 480p로 렌더링되었습니다.
프롬프트 가이드 및 실전 팁
한 비트를 정해진 순서로 쓰기
피사체, 동작 하나, 카메라 움직임 하나, 마지막으로 빛의 순서로 씁니다. 형용사를 쌓는 것보다 분명한 동사 하나가 결과를 더 크게 움직입니다. 계단의 마지막 굽이를 올라 창 앞에서 멈추는 남자라고 쓰면 5초 안에 시작과 끝이 생깁니다.
글자 수는 장면 추가가 아니라 묘사에 쓰기
5,000자면 의상, 세트, 날씨, 빛까지 충분히 적을 수 있지만, 5초 안에 두 번째 사건은 들어가지 않습니다. 지시문에 사건이 여러 개 담겨 있다면 요청을 나누고 편집에서 이어 붙이십시오.
수정하는 동안 시드 고정하기
시드를 하나 정하고, 동사나 카메라 움직임, 화면비처럼 한 가지만 바꾸는 동안 그 값을 유지합니다. 야시장 예시는 시드 250728을 고정해 프롬프트를 고쳐도 같은 프레이밍으로 비교할 수 있게 했습니다. 다양한 결과를 원할 때는 시드를 생략하십시오.
프롬프트 확장은 일찍 정하기
한 줄짜리 아이디어뿐이라면 프롬프트 확장을 켜서 서비스가 더 자세한 지시문을 써 주게 할 수 있습니다. 프롬프트에 이미 피사체, 동작, 카메라, 빛이 들어 있다면 쓴 그대로 실행되도록 꺼 두고, 확장한 결과는 확장하지 않은 결과와 비교해서 판단하십시오.
텍스트만으로 부족한 때를 알아두기
프롬프트만으로는 특정 얼굴이나 제품을 실행할 때마다 같은 모습으로 유지할 수 없습니다. 승인된 스틸 이미지와 피사체가 일치해야 한다면 Wan 2.2 이미지→영상으로 바꾸고 외형은 이미지에 맡기십시오.
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.2/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "480p",
"aspect_ratio": "16:9"
}
}'
# 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 레퍼런스에서 확인하세요.




























