소개
Wan 3.0 영상 연장은 이미 가진 클립의 뒷부분을 만듭니다. video_url에 클립을 넣으세요. 다음에 일어날 일을 프롬프트로 적으면 방향을 잡을 수 있고, 적지 않으면 모델이 장면을 알아서 이어 갑니다. 클립의 마지막 프레임이 2~30초짜리 새 Wan 3.0 이미지 투 비디오 샷의 시작 프레임이 되고, 두 부분은 MP4 한 개로 합쳐집니다. 원본이 먼저, 이어진 부분이 뒤에 오며 이음새에서 겹치는 프레임은 빠집니다. 새 구간도 별도 파일로 돌아오므로 계속 연장하거나 조각별로 편집할 수 있습니다.
핵심 기능 및 하이라이트
연속성은 마지막 프레임에서 나옵니다. 의상, 세트, 조명, 인물의 위치가 이어지는 이유는 새 구간이 말 그대로 그 마지막 프레임에서 시작하기 때문입니다. 움직임은 같은 방식으로 이어지지 않습니다. 모델은 클립 전체가 아니라 정지 이미지 한 장만 보므로, 속도나 방향이 그대로 유지된다고 가정하지 말고 이어 갈 움직임을 적으세요.
끝나는 지점도 원하면 정할 수 있습니다. last_image_url을 넘기면 새 구간이 그 이미지에서 정확히 끝나므로, 샷이 대표 각도로 돌아오거나 정해진 구도에 도착하게 만들 수 있습니다. 넘기지 않으면 끝맺음은 모델이 정합니다. 시작은 언제나 클립의 마지막 프레임입니다.
파일 하나와 새 조각 하나가 돌아옵니다. 합쳐진 MP4는 원본 클립의 프레임 속도와 화면 구도를 유지하며 검은 띠는 들어가지 않습니다. 이음새를 맞추기 위해 화면 가장자리가 몇 퍼센트 정도 잘리거나 조정될 수 있습니다. 모델이 돌려준 영상의 화면 비율이 눈에 띄게 다르면 새 구간을 화면에 꽉 차게 확대해 가운데에 맞추고, 넘치는 부분은 잘라 냅니다. H.264 MP4와 AAC 오디오로 인코딩됩니다. 원본의 소리는 그대로 남고, 새 구간에서 생성한 소리가 그 뒤를 잇습니다. 한쪽이 무음이면 무음으로 채워 이음새에서 화면과 소리가 어긋나지 않습니다. 출력의 두 번째 에셋은 새 구간만 담은 파일로, 다음 연장이나 편집에 바로 쓸 수 있습니다.
그 밖의 모든 것은 Wan 3.0 이미지 투 비디오와 같습니다. 새 구간은 이미지 투 비디오 엔드포인트와 같은 경로, 같은 콘텐츠 허용 범위, 같은 초당 가격으로 만들어지며, 생성이 실패하면 똑같이 환불됩니다. 생성은 성공했지만 합치는 작업만 실패한 경우에도 작업은 실패로 처리되고 요금은 환불됩니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 아니요 | 선택입니다. 비워 두면 모델이 마지막 프레임에서 장면을 알아서 이어 갑니다. 1자 이상 |
video_url | 예 | 이어 갈 클립입니다. MP4, MOV, WebM 형식으로 60초까지 받습니다. 1자 이상 |
last_image_url | 아니요 | 선택 사항인 종료 프레임(이미지 URL)입니다. 새 구간은 이 이미지에서 정확히 끝나며, 느슨한 참고가 아니라 마지막 프레임으로 쓰입니다. |
enable_thinking | 아니요 | 생성 전에 모델이 요청과 참고 자료를 충분히 검토하게 합니다. 분량이 많은 문서, 웹 페이지, 복잡한 참고 이미지에 도움이 되지만 처리 시간이 길어집니다. 기본값: |
resolution | 아니요 | 새 구간을 생성하는 해상도입니다. 480p, 720p, 1080p 중에서 고르며 기본값은 720p입니다. |
duration_seconds | 아니요 | 새 구간의 길이입니다. 2~30 사이의 정수 초 또는 모델에 맡기는 -1을 넣습니다. |
generate_audio | 아니요 | 기본은 켜짐이며, 새 구간에 생성한 소리가 붙습니다. 원본의 소리는 어느 경우든 남습니다. 기본값: |
enable_prompt_expansion | 아니요 | 기본은 꺼짐입니다. 켜면 생성 전에 프롬프트를 다시 쓰는데, 얄팍한 브리프에는 도움이 되고 자세한 브리프와는 다툽니다. 기본값: |
seed | 아니요 | 0에서 2147483647까지입니다. 필드 하나씩 바꿔 비교하려면 고정하고, 다양성을 원하면 빼세요. |
요금
새 구간의 초 단위로, 선택한 해상도에 따라 과금됩니다. 보낸 원본 클립은 과금되지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.045 / 초 |
| $0.09 / 초 |
| $0.18 / 초 |
활용 사례
너무 일찍 끝난 샷을 늘릴 수 있습니다. 라벨이 카메라를 향하기 전에 멈춘 제품 턴테이블이나, 인물이 문에 닿기 전에 끊긴 걷는 장면이 그렇습니다. 몇 초 연장하고 남은 움직임만 적으세요.
긴 시퀀스를 한 단계씩 쌓을 수 있습니다. 첫 샷을 만들어 연장하고, 합쳐진 결과를 다시 연장합니다. 각 단계는 새로 더한 초만 과금됩니다. 단계마다 프레임 한 장에서 시작하므로 다음 단계를 쌓기 전에 이음새를 확인하세요.
프롬프트 가이드 및 실전 팁
장면 전체가 아니라 다음 한 박자를 적으세요. 누가 어디에 있는지는 프레임이 이미 정했으니, 프롬프트는 뒤따르는 동작, 카메라 움직임, 소리에 쓰세요. 클립이 끝날 때의 카메라 표현, 예를 들어 느린 푸시 인이나 고정 샷을 다시 적으면 이음새가 한 테이크처럼 보입니다. 프롬프트는 선택입니다. 쓰지 않으면 모델이 프레임에서 그대로 이어 가며, 분위기 위주이거나 연출 지시가 적은 샷에는 그것으로 충분합니다.
연장하기 전에 다듬으세요. 모델이 보는 것은 마지막 프레임뿐이라서, 흐린 프레임, 컷 중간, 압축이 심한 끝부분은 그대로 이어진 부분에 옮겨 갑니다. 먼저 깨끗하고 선명한 프레임에서 원본을 자르세요. 원본은 MP4, MOV, WebM 형식으로 60초까지 받습니다.
해상도를 맞추세요. 해상도는 새 구간을 얼마나 선명하게 생성할지만 정합니다. 이음새에서 선명도 차이가 보이지 않도록 원본의 해상도에 맞추고 duration_seconds는 정말 필요한 길이로 정하세요. 요금은 새 구간에만 매겨집니다.
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/video-extend",
"input": {
"duration_seconds": 5,
"resolution": "720p",
"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 레퍼런스에서 확인하세요.
