Wan 3.0 Pro Prime API

Wan 3.0 Pro Prime 이미지→영상는 Prime 렌더로 첫 프레임을 움직여 1080p, 2K, 4K에서 2~30초 클립으로 전달합니다. image_url은 필수이며 그대로 첫 프레임이 됩니다. 프롬프트는 생략할 수 있고, 쓴다면 움직임과 카메라를 적어야 합니다. 선택 항목인 last_image_url로 마지막 프레임을 고정할 수 있습니다. 필드는 Wan 3.0 Pro 이미지→영상와 완전히 같으므로, 그 엔드포인트용으로 만든 요청은 모델 이름만 바꾸면 여기서도 동작합니다.

시작 자료에 따라 모드 선택하기

포커스 이동 같은 두 프레임짜리 지시

포커스 이동은 본래 두 프레임으로 이루어지며, last_image_url이 바로 그 용도입니다. 꽃봉오리 예시는 꽃봉오리에 초점이 맞은 프레임에서 시작해, 그 뒤의 단추 풀린 셔츠에 초점이 맞은 넣어 둔 프레임에서 끝나며 4k로 6초입니다. 프롬프트는 초점이 언제 넘어가는지만 말합니다. 피사계 심도가 아주 얕으면 끝을 고정하지 않는 한 올바른 면에 착지할 여지가 거의 없습니다.

상한을 정하는 것은 단계가 아니라 원본

해상도가 결정하는 것은 렌더이지 입력이 아닙니다. 2k와 4k는 네이티브 1080p 렌더를 확대한 것이므로 가진 것 중 가장 선명한 정지 이미지를 넣으십시오. JPEG, 투명도 없는 PNG, BMP, WEBP로 한 변 240~8000픽셀, 최대 20MB, 비율 8:1 이내입니다.

음악을 나중에 붙일 홀드 샷

골목 빛 홀드 예시는 2k로 4초, 오디오와 프롬프트 확장을 모두 끈 홀드입니다. ‘Nobody moves. Only the neon tube above her stutters and the rain keeps falling, dragging its reflection across the wet plastic. Locked camera.’ 자체 소리 없이 편집에서 음악을 붙일 샷을 위한 요청 형태입니다.

움직이지 않는 피사체 주변의 환경 변화

네온 골목 예시는 골목, 비, 투명한 우비가 이미 담긴 자료에서 시작하므로 프롬프트는 바뀌는 것만 적습니다. 더 거세지는 비, 한 번 깜박이는 네온관, 환풍구에서 솟구치는 증기, 그리고 그 내내 렌즈를 응시하는 피사체입니다. 오디오 줄은 철판을 때리는 비, 윙윙대는 네온관, 쉭쉭대는 환풍구처럼 소리의 출처를 하나씩 적습니다.

끝을 고정한 근접 디테일

셔츠 예시는 꽃봉오리 예시와 같은 두 프레임을 1080p, 4초로 다시 씁니다. 비스듬히 비치는 금빛 속에서 손이 열린 셔츠를 천천히 옆으로 젖혔다가 다시 놓고, 그사이 주름 사이의 꽃봉오리가 조금 벌어집니다. 양 끝을 고정하면 아주 얕은 피사계 심도에서도 의도한 면에 착지합니다.

# 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-prime/image-to-video",
  "input": {
    "aspect_ratio": "adaptive",
    "duration_seconds": 5,
    "image_url": "https://example.com/reference.png",
    "resolution": "1080p"
  }
}'

# 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 레퍼런스에서 확인하세요.