Wan 2.6 API

Wan 2.6 참조→영상은 짧은 클립 13개에 담긴 사람, 동물, 사물을 직접 묘사한 새 장면에 출연시킵니다. 누가 또는 무엇이 나오는지는 클립이 정하고, 장소, 동작, 카메라, 조명은 모두 프롬프트에서 나옵니다. 결과물은 210초 사이의 정수 초 길이이며, 720p 또는 1080p, 다섯 가지 화면비 중 하나로, 끊김 없는 원테이크나 멀티숏 편집으로 만들 수 있습니다. 호출 이름은 alibaba/wan-2.6/reference-to-video이고 비동기 방식입니다. 작업을 생성한 뒤 폴링하거나 콜백을 받습니다.

같은 요청에서 클립에 더해, 또는 클립 대신 스틸 이미지를 최대 두 장 보낼 수 있습니다. 클립과 합쳐 레퍼런스는 최대 다섯 개입니다. 스틸 번호는 클립 다음으로 이어져 클립이 두 개면 첫 이미지는 character3이고, 스틸은 과금되지 않습니다.

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

피사체는 옮겨 오고, 배경은 글로 씁니다

누가 또는 무엇이 나오는지는 참조 클립이 정하고, 어디에 있고 무엇을 하며 카메라와 조명이 어떻게 담는지는 프롬프트가 정합니다. 시작 프레임이 세트, 조명, 비율까지 고정하는 이미지→영상과의 차이가 바로 여기에 있습니다. 한 번 촬영한 진행자를 다른 화면비로, 해 질 녘 옥상에 세우는 일을 재촬영 없이 할 수 있습니다.

한 장면에 클립은 최대 3개

피사체 하나를 알아볼 수 있게 유지하려면 클립 1개를, 장면에 여러 피사체가 동시에 필요하면 최대 3개를 보냅니다. 프롬프트에서는 보낸 순서대로 클립을 가리키고 각 클립이 무엇을 제공하는지 적으십시오. 그래야 모델이 누가 진행자이고 무엇이 개인지 알 수 있습니다. 여러 사람이 함께 담긴 복잡한 클립은 누구를 출연시켜야 할지 판단하기 어렵게 만듭니다.

화면비와 크기는 물려받지 않는 파라미터

aspect_ratio는 요청마다 고르며, 16:9, 9:16, 1:1, 4:3, 3:4를 두 해상도 모두에서 쓸 수 있습니다. 720p는 1280×720, 720×1280, 960×960, 1088×832, 832×1088로, 1080p는 1920×1080, 1080×1920, 1440×1440, 1632×1248, 1248×1632로 돌아옵니다. 참조 영상에서 가져오는 것이 없으므로 세로형으로 납품할 때도 세로형 원본 클립이 필요 없고, 같은 참조 세트를 여러 화면비로 납품할 수 있습니다.

진행자를 새로운 장소로 옮기기

인물 클립 하나를 보내고, 공간, 조명, 카메라 움직임은 프롬프트로 지정합니다. 진행자의 외형은 참조에서, 세트는 글에서 나오므로 한 번의 촬영으로 그날 쓸 수 없었던 장소의 영상까지 확보할 수 있습니다.

제품을 시즌 연출에 배치하기

이미 가진 제품 회전 숏을 보내고 새로운 받침, 새로운 계절, 새로운 조명을 묘사합니다. 사물은 형태와 마감을 그대로 유지하고 주변 장면만 새로 만들어지므로, 촬영을 다시 세팅하지 않고도 제품 클립 하나를 여러 캠페인 설정에 쓸 수 있습니다.

두 피사체를 한 장면에 모으기

진행자 클립과 같은 화면에 들어가야 하는 동물이나 사물의 클립을 보내고, 각자 무엇을 하는지 프롬프트에 씁니다. 원래라면 두 피사체를 같은 날 현장에 모아야 했던 장면을 해결합니다.

다시 찍을 수 없는 영상 재활용하기

더 이상 출연할 수 없는 진행자의 아카이브 클립이나 이미 클라이언트에게 돌려준 제품 샘플 영상에도 피사체는 여전히 담겨 있습니다. 그것을 참조로 보내고 새 배경을 쓰십시오. 옛 영상이 피사체를, 프롬프트가 장면을 맡습니다.

# 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-2.6/reference-to-video",
  "input": {
    "aspect_ratio": "16:9",
    "duration_seconds": 5,
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "720p",
    "shot_type": "single",
    "reference_video_urls": [
      "https://example.com/reference.mp4"
    ]
  }
}'

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