소개
Wan 3.0 Spicy 이미지-투-비디오는 Wan 3.0 Spicy 패밀리의 이미지-투-비디오 엔드포인트로, 표준 버전이 완화하는 표현을 렌더링하도록 조정되었습니다. image_url의 시작 프레임과 선택 사항인 prompt로 480p, 720p 또는 1080p의 2~30초 영상이 생성 오디오와 함께 만들어집니다. 정지 화면은 인물, 의상, 세트, 조명을 제공하고, 프롬프트는 움직임, 카메라, 사운드를 제공합니다. 마지막 장면을 고정하려면 last_image_url을 추가하십시오.
요청 본문에 콘텐츠 플래그도, 요청마다 하는 선언도 없습니다. 2026-09-30의 6단계 콘텐츠 테스트에서 모든 단계가 요청한 그대로 나왔습니다.
핵심 기능 및 하이라이트
6단계를 테스트해 6단계 모두 렌더링
표준 콘텐츠 테스트를 480p, 5초로 진행했습니다. 약함부터 최대까지 다섯 강도 단계에 걸친 프롬프트 여섯 개를 사용했습니다(테스트 프롬프트는 공개하지 않습니다). 거부되거나, 가려지거나, 다른 사람으로 바뀐 경우는 하나도 없었고, 어떤 프롬프트도 수위를 낮출 필요가 없었습니다.
프롬프트 이상으로 스스로 나아간다
이 부분은 계획에 반드시 넣어야 합니다. 예시 촬영에서는 의상이 그대로 유지된다고 적힌 프롬프트와 함께 시작 프레임을 여섯 개 보냈는데, 그중 네 개는 의상이 바뀐 채 돌아왔습니다. 사람이 두 명 이상 나온 프레임은 모두 여기에 포함됩니다. 프롬프트는 보장이 아니라 요청으로 보고, 클립 전체를 검토하십시오.
한 번의 요청으로 최대 30초
duration_seconds는 2에서 30 사이의 정수라면 어떤 값이든 되고, 기본값은 5입니다. 5초 요청은 초당 30프레임, 약 5.04초 분량을 돌려줍니다. resolution은 480p, 720p(기본값), 1080p이며, 길이와 해상도 모두 가격과 소요 시간에 영향을 줍니다.
형태, 소리, 마지막 프레임
aspect_ratio는 16:9, 9:16, 1:1, 4:3, 3:4를 받고, 생략하면 클립이 스틸의 형태를 따릅니다. generate_audio는 기본값이 켜짐입니다. last_image_url은 마지막 프레임을 고정합니다. 테스트에서 클립은 요청한 비율로 크롭된 채 넘긴 이미지에서 끝났습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 아니요 | 선택 사항이지만 적어 둘 가치가 있습니다: 동작 하나, 카메라 움직임 하나, 소리에 관한 메모 하나. 이 모델에서는 의상을 바꾸지 말라고 요청해도 확실하게 유지되지는 않습니다. 1자 이상 |
image_url | 예 | 필수입니다. 인물, 의상, 공간, 빛이 모두 이 첫 프레임에서 옵니다. |
last_image_url | 아니요 | 선택 사항인 마지막 프레임입니다. 클립이 이 이미지에서 끝나며, 요청한 화면비로 크롭됩니다. |
aspect_ratio | 아니요 | 16:9, 9:16, 1:1, 4:3, 3:4. 생략하면 클립이 첫 프레임의 형태를 따르고, 다른 비율을 지정하면 프레임이 크롭됩니다. |
resolution | 아니요 | 480p, 720p, 1080p, 기본값은 720p입니다. 해상도가 높을수록 초당 비용이 늘고 시간이 더 걸립니다. |
duration_seconds | 아니요 | 2에서 30 사이의 정수라면 어떤 값이든 되고, 기본값은 5입니다. 요청한 초 단위로 과금됩니다. |
generate_audio | 아니요 | 기본값은 켜짐이며 추가 요금은 없습니다. 화면에 맞춘 소리와 함께 클립이 돌아옵니다. 기본값: |
enable_prompt_expansion | 아니요 | 기본값은 꺼짐이며 추가 요금은 없습니다. 켜면 짧은 프롬프트가 생성 전에 더 긴 문장으로 다시 쓰입니다. 기본값: |
seed | 아니요 | 0에서 2147483647. 해상도나 길이를 비교하는 동안 고정해 두세요. |
요금
| 사양 | 요금 |
|---|---|
| $0.057 / 초 |
| $0.114 / 초 |
| $0.228 / 초 |
활용 사례
다른 API가 거부하는 장면
다른 API가 거부하거나 완화하는 장면: 정지 화면을 보내고 움직임을 설명하면 클립을 받습니다. 사용할 수 있는 것은 동의한 성인과 적법하게 라이선스된 소재뿐이며, 등장하는 모든 사람에 대한 권리, 나이, 현지 법률은 사용자가 책임집니다.
컴패니언·롤플레이 캐릭터
캐릭터 스틸 한 장을 모든 클립의 첫 프레임으로 재사용하고 동작만 바꾸세요. 얼굴과 의상은 스틸이 담고 있어서 클립이 바뀌어도 같은 인물로 유지됩니다.
끝을 정해 두는 롱테이크
최대 30초를 요청하고 last_image_url을 넣으면, 다음 샷이 시작되는 포즈에서 테이크가 끝납니다.
프롬프트 가이드 및 실전 팁
스타일링은 프레임에 맡기세요
의상, 공간, 빛은 스틸에 담고 프롬프트에는 움직이는 것만 적으세요. 이 페이지의 창가 예시는 duration_seconds 5, resolution 720p로 실행했습니다.
She turns from the rainy window toward the camera; the loose strap slides a little further down her shoulder and she lets it rest there, a slow half smile. Pink and cyan neon ripples over the wet glass and her collarbone. She stays in the velvet dress the whole time. Slow push-in. Rain on the glass, distant traffic hum.
이 엔드포인트에서 옆에 보이는 첫 프레임으로 만든 클립의 실제 요청 그대로입니다.
480p로 초안, 그다음 렌더링
5초짜리 480p 클립은 테스트에서 약 1분 30초가 걸렸습니다. 거기서 아이디어를 굳히고 seed를 고정한 채 720p나 1080p로 다시 렌더링하세요. 비교가 의미를 갖도록 한 번에 필드 하나만 바꾸세요.
옷이 유지되어야 할 때
어떤 프롬프트 문구로도 이 모델이 피사체의 의상을 바꾸는 것을 확실히 막을 수는 없습니다. 의상이 끝까지 유지되어야 하는 클립에는 표준 Wan 3.0 이미지-투-비디오를 사용하고, Spicy는 그 경향 자체가 목적인 장면에 남겨 두십시오.
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-spicy/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p"
}
}'
# 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 레퍼런스에서 확인하세요.



























