Wan 3.0 Prime API

Wan 3.0 Prime 레퍼런스→영상는 Prime 렌더로 이미지 최대 10장, 영상 5개, 오디오 5개의 참조를 받아 2~30초 샷을 만들며, 필드는 Wan 3.0 레퍼런스→영상와 같습니다. 참조 배열, 참조 파일, 웹 링크 중 최소 하나가 있어야 하고 프롬프트는 생략할 수 있지만, 쓴다면 각 참조가 무엇을 맡는지 밝혀야 합니다. 해상도는 480p, 720p, 1080p(기본값 720p)이고 aspect_ratio의 기본값은 16:9입니다.

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

인물 자료 한 장, 텍스트로 만드는 장면 전체

자료 한 장이 인물을 맡고 나머지는 프롬프트가 모두 만들어 낼 수 있습니다. 모래언덕 예시는 무지 스튜디오 배경에서 평평하게 찍은 인물 이미지 한 장만 쓰고, 달빛 비치는 모래언덕, 바람, 그녀 위로 흩날리는 몇 미터짜리 스카프는 전부 글로 썼습니다. 테이크 끝에서도 스카프가 같은 팔에 이어져 있어야 하므로 확인하기 좋은 지점입니다.

클립에서 빌려 오는 카메라 움직임

참조 영상은 얼굴이 아니라 움직임과 카메라 스타일을 위한 것입니다. 모션 스타일 예시는 참조 클립에서 느린 핸드헬드 오빗을 가져와, 빈 스튜디오에 선 참조 이미지 속 여성에게 적용하며 720p에서 6초입니다. 참조 클립은 MP4나 MOV, 16fps 이상, 클립당 1~15초, 합계 15초 이내여야 합니다.

참조 오디오로 이어 가는 목소리

WAV나 MP3 참조 오디오를 합계 15초 이내로 최대 5개 넣어 테이크마다 목소리를 유지할 수 있습니다. 겉모습은 이어져도 샷마다 목소리가 다른 진행자는 연속적이지 않습니다. 한 인물이 여러 샷에서 말한다면 매번 같은 참조 오디오를 보내십시오. 참조 오디오와 참조 이미지는 과금되지 않습니다.

반복 등장하는 진행자

시리즈의 모든 요청에 얼굴과 세트는 같은 이미지 자료를, 목소리는 같은 참조 오디오를 쓰십시오. 진행자 예시는 ‘the same presenter, the same studio’를 유지하고 움직임, 즉 특정 프레이밍에서 끝나는 푸시만 묘사합니다. 인물의 동일성은 이미 참조가 담당하기 때문입니다.

스타일을 맞춘 인서트

새 샷이 기존 샷과 같은 방식으로 움직여야 한다면 그 클립을 움직임 참조로, 피사체는 이미지로 넣으십시오. 모션 스타일 예시처럼 무엇이 무엇인지 프롬프트에 밝힙니다. ‘Take the camera behaviour from the reference clip — a slow handheld orbit — and apply it to the woman in the reference image.’

# 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-prime/reference-to-video",
  "input": {
    "aspect_ratio": "16:9",
    "duration_seconds": 5,
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "reference_image_urls": [
      "https://example.com/reference.png"
    ],
    "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 레퍼런스에서 확인하세요.