Wan 3.0 Pro API

Wan 3.0 Pro 레퍼런스→영상는 이미지, 영상, 오디오 참조로 얼굴, 의상, 세트, 움직임, 목소리를 여러 샷에 걸쳐 유지하고, 결과를 1080p, 2K, 4K에서 230초로 전달합니다. reference_image_urls(순서가 있는 이미지 110장), reference_video_urls, reference_audio_urls(각각 클립 최대 5개), reference_file_url(문서 1개), reference_link_url(웹 페이지 1개) 중 최소 하나를 보내십시오. 프롬프트는 생략할 수 있지만, 각 참조에 역할을 주고 동작을 적는 곳이 바로 프롬프트입니다.

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

마스터 하나, 여러 크롭

참조로 고정한 샷을 4K로 렌더링하면 배너용으로도, 세로형 컷다운용으로도 잘라 쓸 수 있는 마스터가 됩니다. 의상 예시는 코트 자료 한 장(‘Keep the coat from the reference exactly — cut, colour and stitching’)을 보내고 오디오를 끈 채 4k로 6초를 렌더링합니다. 모델이 어두운 무대에서 한 번 돌고, 밑단이 들렸다가 가라앉습니다.

전달 크기에서는 어긋남이 더 잘 보입니다

샷 사이에서 얼굴이 바뀌면 고해상도에서는 바로 눈에 띕니다. 이것은 검토에 도움이 됩니다. 시퀀스의 각 샷을 전달 크기로 렌더링하고, 확정하기 전에 나란히 비교하십시오. 2k와 4k는 네이티브 1080p 렌더를 확대한 것이므로 렌더에서 생긴 불일치를 가리지 않고 오히려 드러냅니다.

참조 자료 예산

참조 이미지와 참조 오디오는 과금되지 않으며, 참조 영상의 초는 출력과 함께 과금됩니다. 영상과 오디오 참조는 각각 합계 15초까지이고 클립마다 1~15초여야 하며, 참조 영상과 duration_seconds의 합은 30초 이내여야 합니다. 이 제한은 제출 시점이 아니라 생성 중에 적용되므로 클립 길이를 먼저 확인하십시오.

얼굴과 세트에 이름을 붙인 시리즈 샷

얼굴과 세트 예시는 자료 두 장과 동작 한 줄을 보냅니다. ‘The first image is the character — keep her face, hair and the black gown. The second image is the room.’ 그녀는 느린 수평 트래킹 속에서 문간에서 창가까지 걸어갑니다. 1080p에서 8초, 시드는 640117입니다. 한 회차의 모든 샷에 같은 자료와 시드를 쓰고 동작만 바꾸십시오.

같은 두 사람, 다른 빛

하루 세 시간대 예시는 빛이 바뀌는 동안 두 사람과 아파트 하나를 유지합니다. 창가의 아침, 주방 조리대의 해 질 녘, 발코니의 밤입니다. 빛을 뺀 모든 것이 유지되어야 하므로 연속성 면에서 까다로운 경우입니다. 인물과 방은 참조가 맡으므로 프롬프트에는 달라지는 부분만 적습니다.

# 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/reference-to-video",
  "input": {
    "aspect_ratio": "adaptive",
    "duration_seconds": 5,
    "reference_image_urls": [
      "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 레퍼런스에서 확인하세요.