Wan 3.0 Pro Prime API

Wan 3.0 Pro Prime 레퍼런스→영상는 이미지, 영상, 오디오 참조로 얼굴, 의상, 세트, 움직임, 목소리를 고정하고 Prime 렌더로 1080p, 2K, 4K의 230초 샷을 만듭니다. reference_image_urls(순서가 있는 이미지 110장), reference_video_urls, reference_audio_urls(각각 클립 최대 5개), reference_file_url(문서 1개), reference_link_url(웹 페이지 1개) 중 최소 하나가 필요합니다. 각 참조에 프롬프트에서 이름을 붙이십시오. 그렇지 않으면 모델이 이를 평균 내어 어느 것과도 맞지 않는 피사체를 만듭니다.

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

한 샷에 두 인물

두 인물 예시는 자료 두 장을 보내고 이름을 붙입니다. ‘The first image is the woman, the second is the man — keep both faces and both haircuts.’ 두 사람은 어둑한 차고의 작업대 양쪽에 서 있고 빛은 매달린 전구 하나뿐이며, 1080p에서 6초, 시드 220913, 소리는 룸톤만 있습니다. 한 회차 내내 커플을 일관되게 유지하는 패턴입니다.

사람 없는 세트 자료

참조가 꼭 사람일 필요는 없습니다. 세트 연속성 예시는 권투 체육관(로프, 사물함, 매달린 조명 하나) 자료 한 장을 보내고, 빛줄기 사이로 먼지가 떠다니고 전구가 천천히 흔들리는 빈 화면을 고정 카메라, 4k, 5초, 오디오 끔으로 요청합니다. 그러면 시퀀스의 모든 샷이 같은 방을 공유할 수 있습니다.

글로 쓰는 대신 참조하는 움직임

이미지, 영상, 오디오 참조를 함께 넣을 수 있으므로 움직임을 문단 대신 클립에서 가져올 수 있습니다. 참조 영상은 MP4나 MOV, 16fps 이상, 클립당 1~15초, 합계 15초이며, 그 초는 출력과 함께 과금되고 참조 영상과 출력의 합은 30초 이내로 유지됩니다.

여러 무대를 거치는 의상

댄서 예시는 한 명의 퍼포머와 겹겹이 쌓인 시폰 의상 한 벌을 세 번째 무대로 옮깁니다. 이번에는 팔로 스폿이 뒤에서 비쳐 그녀가 돌 때마다 천이 비칩니다. 댄서와 의상은 참조가 맡으므로 프롬프트는 새 조명 구성만 묘사하며, 역광에 비치는 천은 큰 전달 크기에서 거의 아무것도 숨겨 주지 않습니다.

다시 편집되는 마스터 파일

참조로 고정한 대표 샷을 16:9, 4K로 렌더링한 뒤 같은 마스터에서 9:16 컷다운과 정사각형 배너를 잘라 내십시오. 참조 자료와 고정 시드가 세트의 모든 파생본에서 출연진을 똑같이 유지합니다.

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