Wan 3.0 API

Wan 3.0 레퍼런스→영상는 넣어 준 참조 자료로 2~30초짜리 새 샷을 만듭니다. 요청 하나에 이미지 10장, 영상 클립 5개, 오디오 클립 5개까지 넣을 수 있습니다. reference_image_urls, reference_video_urls, reference_audio_urls, reference_file_url, reference_link_url 중 최소 하나가 있어야 하며, 프롬프트는 생략할 수 있습니다. 따로 렌더링한 여러 샷에서 얼굴, 의상, 장소, 목소리가 똑같이 유지되어야 할 때 사용합니다. text-to-video는 실행할 때마다 새 얼굴을 만들어 내므로 이 일을 할 수 없습니다. 출력은 480p, 720p, 1080p이며 기본값은 720p입니다.

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

이미지는 인물, 의상, 세트를 위해

reference_image_urls에는 인물, 의상, 세트 자료로 쓸 이미지를 110장 넣을 수 있습니다. 형식은 JPEG, 투명도 없는 PNG, BMP, WEBP이며 한 변 2408000픽셀, 장당 최대 20MB입니다. 참조 이미지는 과금되지 않습니다. 각 이미지가 무엇인지 프롬프트에서 이름을 붙여 주십시오. 그렇지 않으면 모델이 이미지를 평균 내어 어느 것과도 닮지 않은 피사체를 만듭니다.

영상은 움직임을, 오디오는 목소리를

참조 영상이 전달하는 것은 얼굴이 아니라 움직임과 카메라 스타일입니다. MP4나 MOV 클립을 최대 5개, 클립당 1~15초, 합계 15초 이내, 16fps 이상으로 넣을 수 있습니다. 참조 오디오는 목소리, 대사 톤, 룸톤을 전달하며 WAV나 MP3 클립을 최대 5개, 역시 합계 15초 이내로 넣습니다. 이 제한은 작업이 접수될 때가 아니라 생성 중에 검사되므로, 제출하기 전에 클립 길이를 재 두십시오.

출력과 함께 쓰는 30초 예산

참조 영상의 초는 출력과 함께 과금되며, 참조 영상 길이와 duration_seconds의 합은 30초를 넘을 수 없습니다. 예를 들어 12초짜리 움직임 참조를 쓰면 출력은 최대 18초가 됩니다. 참조 이미지와 참조 오디오는 이 예산에 포함되지 않습니다.

정해진 방에서 같은 인물을 다시 렌더링하기

인물과 방 예시는 이미지 두 장을 보내고 프롬프트에서 역할을 지정합니다. ‘Image 1 is the character — keep her face, hair and the black slip dress exactly. Image 2 is the room.’ 그다음 느린 수평 트래킹 속에서 그녀가 창가로 걸어갑니다. 720p에서 8초, 시드는 771120입니다. 두 자료와 시드를 고정하고 동작 줄만 바꾸는 것이 시리즈 작업에 맞는 요청 형태입니다.

목소리까지 맞춘 화자

독백 예시는 화자의 얼굴과 의상을 위한 이미지 한 장과 목소리를 위한 참조 오디오 하나를 짝지었습니다. 프롬프트는 두 역할을 분리한 다음, 아침 햇살이 드는 주방 식탁에서의 고정 미디엄 샷을 묘사합니다. 720p에서 10초입니다. 테이크마다 같은 목소리여야 하는 진행자, 내레이터, 반복 등장인물은 이 패턴을 따르면 됩니다.

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