소개
Wan 2.6 이미지→영상은 image_url로 보낸 프레임에서 출발해 정확히 5초, 10초 또는 15초 길이의 720p 또는 1080p 클립을 사운드와 함께 돌려줍니다. 피사체, 의상, 세트, 빛의 방향, 클립의 비율은 이 프레임이 정합니다. 프롬프트는 선택 사항이며 최대 1,500자까지 쓸 수 있습니다. 원테이크라면 동작 하나를, 멀티숏 편집이라면 번호를 매긴 숏을 적습니다.
시작 자료에 따라 모드 선택하기
| 처음에 가진 것 | 모드 |
|---|---|
| 글로 쓴 장면이나 대본 | Wan 2.6 텍스트→영상 |
| 승인된 시작 이미지 | Wan 2.6 이미지→영상 |
| 외형, 움직임, 소리를 따로 담은 참조 자료 | Wan 2.6 참조→영상 |
핵심 기능 및 하이라이트
화면비와 외형은 프레임이 결정
화면비 필드는 없습니다. 클립은 보낸 이미지의 비율을 그대로 유지하므로 9:16으로 납품하려면 9:16으로 자른 이미지에서 시작합니다. 프레임은 JPEG, 투명도 없는 PNG, BMP, WEBP 중 하나여야 하며, 각 변이 240~8,000픽셀이고 20MB를 넘지 않아야 합니다. 프레임에 보이는 것은 이미 정해졌으므로 프롬프트는 움직임을 묘사하는 데 온전히 쓸 수 있습니다.
한 장의 프레임에서 나누는 커버리지
shot_type을 multi로 두면 모델이 시작 프레임의 룩을 유지하면서 앵글을 전환할 수 있습니다. 그래서 15초 클립에 흘러가기만 하는 카메라 움직임 하나 대신 설정 숏, 디테일, 마무리 숏을 담을 수 있습니다. multi 요청은 항상 프롬프트 확장을 켠 상태로 실행됩니다. 제품 회전, 말하는 인물, 끊기면 안 되는 장면은 single로 유지하십시오. multi는 설계상 연속성을 깨기 때문입니다.
생성하거나 직접 넣는 사운드
클립은 화면과 같은 생성 과정에서 만들어진 오디오와 함께 돌아옵니다. 대사나 음악의 박자를 원하는 위치에 맞추려면 audio_url을 보냅니다. 형식은 WAV 또는 MP3, 길이는 3~30초, 크기는 최대 15MB입니다. 트랙이 더 길면 클립 길이에서 잘리고, 더 짧으면 클립의 나머지는 무음이 됩니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
image_url | 예 | 첫 프레임입니다. 피사체, 의상, 세트, 빛의 방향, 클립 비율이 모두 여기서 나오니 먼저 크롭하세요. |
prompt | 아니요 | 선택입니다. 원테이크라면 동작 하나를, 멀티샷이라면 번호 붙은 샷을 적습니다. 1자 이상 · 1500자 이하 |
negative_prompt | 아니요 | 나오면 안 되는 것을 적습니다. 두 번째 인물, 자막, 프레임에서 자꾸 따라오는 소품 같은 것들입니다. 500자 이하 |
resolution | 아니요 | 720p 또는 1080p이며 기본값은 720p입니다. 초당 단가와 처리 시간이 달라집니다. |
duration_seconds | 아니요 | 정확히 5, 10, 15 중 하나입니다. 멀티샷은 긴 길이일수록 여유가 생깁니다. |
audio_url | 아니요 | 클립이 따라갈 대사나 음악 큐입니다. 말과 비트가 예상한 자리에 떨어집니다. |
shot_type | 아니요 | single은 원테이크를 유지하고, multi는 모델이 샷을 전환합니다. 짧은 이야기에 어울리지만 연속성은 끊깁니다. |
enable_prompt_expansion | 아니요 | 기본으로 꺼져 있습니다. 켜면 한 줄 아이디어가 멀티샷용 샷 목록으로 펼쳐지니, 프롬프트가 이미 정밀하다면 꺼 두세요. 기본값: |
seed | 아니요 | 0에서 2147483647까지입니다. 같은 프레임으로 single과 multi를 비교할 때 고정하세요. |
요금
| 사양 | 요금 |
|---|---|
| $0.09 / 초 |
| $0.135 / 초 |
활용 사례
튀면 안 되는 제품 매크로 숏
세럼 예시는 스포이트 병 사진을 고정한 시드로 1080p, 5초 동안 움직입니다. 스포이트 끝에서 물방울 하나가 떨어지고, 액체 표면에 물결이 퍼지며, 유리에 비친 빛의 띠가 조금 밝아집니다. 구도는 고정된 매크로이고 유리가 살짝 울리는 소리를 곁들였습니다. 제품 숏은 앵글 사이를 오가면 안 되므로 원테이크로 유지합니다.
사진 한 장으로 만드는 짧은 실내 이야기
저녁 아파트 예시는 shot_type을 multi로 두고 프롬프트 확장을 켠 채 720p로 15초 동안 진행됩니다. 실내 프레임 하나에서 숏 세 개가 나옵니다. 램프가 깜박이는 사이 창밖 도시의 불빛이 켜지고, 개어 둔 담요가 안락의자에서 미끄러져 내려오며, 현관문이 열리면서 복도의 불빛이 마룻바닥 위로 번집니다. 소리는 조용한 실내 공기와 먼 차 소리입니다.
직접 녹음한 대사를 말하는 캐릭터
캐릭터 이미지에 녹음한 대사를 audio_url로 짝지으면, 일반적인 움직임이 아니라 원하는 위치에서 대사가 나옵니다. 말하는 인물은 single로 만들고 전체 길이도 확인하십시오. 트랙이 클립보다 짧으면 남은 부분은 무음으로 재생됩니다.
프롬프트 가이드 및 실전 팁
글을 쓰기 전에 프레임부터 준비하기
납품 형식에 맞게 자르고, 원하는 의상, 세트, 조명이 이미 프레임에 담겨 있는지 확인하십시오. 첫 프레임이 잘못되면 어떤 프롬프트로도 되돌릴 수 없습니다. 움직이게 하고 싶지 않은 자막이나 두 번째 피사체는 지우고, 소품이나 화면 속 글자처럼 프레임이 자꾸 되살리는 것은 최대 500자인 negative_prompt로 막습니다.
이미 보이는 것이 아니라 움직임을 쓰기
원테이크에서는 동작 하나와 카메라 움직임 하나를 씁니다. 세럼 프롬프트는 물방울, 물결, 빛의 띠 변화, 구도, 소리 하나만 이야기하고 병의 모양이나 라벨은 전혀 언급하지 않습니다. 그것은 이미 프레임이 담고 있기 때문입니다.
A single drop falls from the dropper tip into the bottle and sends slow rings across the liquid surface; the light band on the glass brightens a little. Locked macro framing, soft chime of glass.
멀티숏 편집 설계하기
숏마다 고유한 프레이밍을 붙여 번호를 매기고, 컷이 들어갈 여유가 있도록 10초나 15초를 고릅니다. multi를 선택하면 그 요청에서는 enable_prompt_expansion이 켜집니다. 원테이크에서는 기본값이 꺼짐이라 정확하게 쓴 프롬프트가 쓴 그대로 전송됩니다.
같은 프레임으로 single과 multi 비교하기
seed를 0~2147483647 범위에서 고정하고 프레임과 프롬프트를 그대로 둔 채, 같은 요청을 single과 multi로 한 번씩 실행해 어느 쪽이 숏에 맞는지 확인합니다. 해상도는 초당 요금과 작업 소요 시간을 정하므로 문구는 720p에서 다듬은 뒤 1080p로 렌더링하십시오. 시드를 고정하면 비교가 안정되지만 프레임 단위로 똑같은 재생성을 약속하지는 않습니다.
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/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"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 레퍼런스에서 확인하세요.
