소개
Wan 3.0 Pro 영상 연장은 이미 가지고 있는 클립을 이어 갑니다. video_url로 클립을 보내고, 원하면 다음에 일어날 일을 프롬프트로 적으세요. 클립의 마지막 프레임이 2~30초 길이의 새 Wan 3.0 Pro 이미지 투 비디오 샷의 시작 프레임이 되고, 둘은 MP4 한 개로 합쳐집니다. 원본이 먼저, 이어진 부분이 그다음이며 이음매에서 겹치는 프레임은 제거됩니다. 새 구간은 단독 파일로도 돌아오므로 계속 연장하거나 조각별로 편집할 수 있습니다.
핵심 기능 및 하이라이트
연속성은 마지막 프레임에서 나옵니다. 의상, 세트, 빛, 사람들의 위치가 이어지는 것은 새 구간이 말 그대로 마지막 프레임에서 시작하기 때문입니다. 움직임은 같은 방식으로 이어지지 않습니다. 모델이 보는 것은 클립 전체가 아니라 정지 이미지 한 장이므로, 속도나 방향이 그대로 이어지리라 기대하지 말고 이어 가려는 움직임을 적어 주세요.
끝나는 장면도 정할 수 있습니다. last_image_url은 선택 사항인 목표 마지막 프레임으로, 새 구간이 그 이미지에서 정확히 끝납니다. 제품을 대표 각도로 되돌리거나 움직임을 정해진 구도에 도착시켜야 할 때 알맞습니다. 넣지 않으면 샷이 어떻게 끝날지는 모델이 정합니다.
해상도 단계는 Wan 3.0 Pro 이미지 투 비디오와 같은 1080p, 2k, 4k입니다. 네이티브 렌더링은 1080p가 한계라서 2k와 4k는 이를 확대한 것이며, 480p와 720p 단계는 없습니다.
파일 하나와 새 조각 단독 파일이 돌아옵니다. 합쳐진 결과는 H.264 MP4에 AAC 소리로 만들어집니다. 원본 클립의 프레임 레이트와 화면 구성을 그대로 유지하며 검은 띠는 생기지 않습니다. 이음매를 맞추기 위해 화면 가장자리가 몇 퍼센트 정도 잘리거나 조정될 수 있습니다. 모델이 돌려준 영상의 화면 비율이 눈에 띄게 다르면 새 구간을 화면에 꽉 차게 확대해 가운데에 맞추고, 넘치는 부분은 잘라 냅니다. 원본의 소리는 그대로 남고, 새 구간에서 생성된 소리가 그 뒤를 잇습니다. 한쪽이 무음이면 무음으로 채워 이음매에서도 화면과 소리가 어긋나지 않습니다. 출력의 두 번째 에셋은 새 구간만 담은 파일이어서 다음 연장이나 편집에 바로 쓸 수 있습니다.
나머지는 모두 Wan 3.0 Pro 이미지 투 비디오와 같습니다. 콘텐츠 허용 범위와 초당 가격이 같고, 생성에 실패했을 때의 환불도 같습니다. 생성은 성공했지만 이어 붙이기를 만들지 못한 경우에도 작업이 실패 처리되고 요금이 환불됩니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 아니요 | 선택 사항입니다. 다음에 일어날 일, 즉 이어지는 동작과 카메라 움직임을 적으세요. 1자 이상 · 20000자 이하 |
video_url | 예 | 이어 갈 클립입니다. MP4, MOV, WebM 형식으로 60초까지 받습니다. 1자 이상 |
last_image_url | 아니요 | 선택 사항인 목표 마지막 프레임입니다. 새 구간은 이 이미지에서 정확히 끝나며, 느슨한 참고가 아니라 마지막 프레임으로 쓰입니다. 1자 이상 |
resolution | 아니요 | 새 구간의 해상도 단계입니다. 1080p, 2k, 4k 중에서 고르며 기본값은 1080p입니다. |
duration_seconds | 아니요 | 새 구간의 길이입니다. 2~30 사이의 정수 초 또는 모델에 맡기는 -1을 넣습니다. |
generate_audio | 아니요 | 기본으로 켜져 있어 새 구간에 생성된 소리가 붙습니다. 원본은 어느 쪽이든 자기 소리를 그대로 유지하며, 한쪽이 무음이면 합쳐진 파일은 무음으로 채워집니다. 기본값: |
enable_prompt_expansion | 아니요 | 기본으로 켜져 있습니다. 생성 전에 프롬프트를 확장하므로 짧은 지시에는 도움이 되지만 정밀한 지시와는 부딪힙니다. 기본값: |
seed | 아니요 | 0~2147483647입니다. 바꾼 항목을 하나씩 비교하려면 고정하고, 다양한 결과를 원하면 비워 두세요. |
요금
새 구간의 초 단위로, 선택한 해상도 단계에 따라 과금됩니다. 보낸 원본 클립은 과금되지 않습니다. 새 구간은 생성됐지만 이어 붙이기를 만들지 못하면 작업이 실패 처리되고 전액 환불됩니다.
| 사양 | 요금 |
|---|---|
| $0.144 / 초 |
| $0.16 / 초 |
| $0.184 / 초 |
활용 사례
너무 일찍 끝난 샷을 늘릴 수 있습니다. 라벨이 카메라를 향하기 전에 멈춘 제품 턴테이블이나 인물이 문에 닿기 전에 끊긴 걷기 장면이 그 예입니다. 몇 초 연장하고 남은 움직임만 적으세요.
더 긴 시퀀스를 한 단계씩 쌓을 수 있습니다. 첫 샷을 만들어 연장하고, 합쳐진 결과를 다시 연장하세요. 각 단계에서 과금되는 것은 그 단계가 늘린 초뿐입니다. 모든 단계가 프레임 한 장에서 시작하므로 다음 단계를 쌓기 전에 이음매를 확인하세요.
프롬프트 가이드 및 실전 팁
장면 전체가 아니라 다음 한 박자를 적으세요. 누가 어디에 있는지는 프레임이 이미 정하므로, 프롬프트는 이어지는 동작과 카메라 움직임에 쓰세요. 클립이 끝난 카메라 표현, 예를 들어 느린 푸시인이나 고정 샷을 반복하면 이음매가 하나의 테이크처럼 읽힙니다. 프롬프트는 선택 사항이며, 생략하면 모델이 프레임만 보고 이어 갑니다.
연장하기 전에 먼저 자르세요. 모델이 보는 것은 마지막 프레임뿐이라서 흐릿하거나 컷 도중이거나 압축이 심한 끝부분은 그대로 이어지는 부분에 들어갑니다. 먼저 깨끗하고 선명한 프레임에서 원본을 잘라 두세요. 60초까지의 원본을 MP4, MOV, WebM으로 받습니다.
해상도 단계는 원본에 맞추고 duration_seconds는 정말 필요한 길이로 정하세요. 요금은 새 구간만 따릅니다. 2k나 4k 렌더링에 비용을 쓰기 전에 1080p와 고정한 seed로 움직임을 먼저 확정하세요.
API 빠른 시작
# 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/video-extend",
"input": {
"duration_seconds": 5,
"resolution": "1080p",
"video_url": "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 레퍼런스에서 확인하세요.
