소개
Wan 2.5 영상 연장은 이미 가지고 있는 클립을 이어 갑니다. video_url로 클립을 보내고 원하면 다음에 일어날 일을 프롬프트로 적습니다. 클립의 마지막 프레임이 5초 또는 10초짜리 새 Wan 2.5 이미지→영상 샷의 시작 프레임이 되고, 둘은 하나의 MP4로 이어집니다. 원본이 먼저, 이어진 부분이 그다음이며 이음매에서 겹치는 프레임은 제거됩니다. 새 구간은 별도 파일로도 돌아오므로 계속 연장하거나 조각별로 편집할 수 있습니다.
핵심 기능 및 하이라이트
연속성은 마지막 프레임에서 나옵니다. 새 구간이 말 그대로 마지막 프레임에서 시작하기 때문에 의상, 세트, 조명, 인물의 위치가 이어집니다. 움직임은 같은 방식으로 이어지지 않습니다. 모델은 클립 전체가 아니라 정지 이미지 한 장을 보므로, 속도나 방향이 유지되리라 가정하지 말고 이어 갈 움직임을 적어 주세요.
파일 하나와 새 조각 단독 파일이 돌아옵니다. 이어 붙인 MP4는 원본 클립의 프레임 속도와 화면 구도를 유지하며 검은 띠는 들어가지 않습니다. 이음새를 맞추기 위해 화면 가장자리가 몇 퍼센트 정도 잘리거나 조정될 수 있습니다. 모델이 돌려준 영상의 화면 비율이 눈에 띄게 다르면 새 구간을 화면에 꽉 차게 확대해 가운데에 맞추고, 넘치는 부분은 잘라 냅니다. H.264 MP4와 AAC 사운드로 인코딩됩니다. 원본의 소리는 그대로 남고, 새 구간의 소리가 그 뒤를 잇습니다. 한쪽이 무음이면 무음으로 채워서 이음매에서도 화면과 소리가 맞습니다. 출력의 두 번째 에셋은 새 구간만 담은 파일로, 다음 연장이나 편집기에 바로 쓸 수 있습니다.
새로 만드는 부분에는 직접 준비한 소리를 쓸 수 있습니다. audio_url을 넘기면 새 구간이 그 트랙에 맞춰 만들어지므로 대사나 박자가 기대한 자리에 떨어집니다. 새 구간에만 작용하며, 원본은 원래 소리를 유지한 채 둘이 있는 그대로 이어집니다.
그 밖의 모든 것은 Wan 2.5 이미지→영상과 같습니다. 새 구간은 이미지→영상 엔드포인트와 같은 경로, 같은 콘텐츠 범위, 같은 초당 요금으로 생성되며, 생성이 실패하면 같은 방식으로 환불됩니다. 생성은 성공했지만 이어 붙이기만 만들지 못한 경우에도 작업은 실패로 처리되고 요금이 환불됩니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 아니요 | 선택 사항입니다. 다음에 일어날 일, 즉 이어지는 동작, 카메라 움직임, 소리에 대한 한 줄을 적습니다. 1500자 이하 |
negative_prompt | 아니요 | 새 구간에 나오면 안 되는 것입니다. 두 번째 인물, 자막, 마지막 프레임이 자꾸 끌어들이는 소품 등을 적습니다. 500자 이하 |
video_url | 예 | 이어 가려는 클립입니다. 최대 60초의 MP4, MOV, WebM. 1자 이상 |
resolution | 아니요 | 새 구간을 생성하는 해상도입니다. 480p, 720p, 1080p 중에서 고르며 기본값은 720p입니다. |
duration_seconds | 아니요 | 새 구간의 길이입니다. 정확히 5초 또는 10초이며 기본값은 5입니다. |
audio_url | 아니요 | 새 구간에 쓸 오디오입니다. 따라갈 대사나 음악 큐를 넣으면 말소리와 박자가 기대한 자리에 떨어집니다. 1자 이상 |
enable_prompt_expansion | 아니요 | 기본값은 꺼짐입니다. 한 줄짜리 아이디어에는 켜고, 프롬프트가 이미 정확한 동작이면 꺼 두세요. 기본값: |
seed | 아니요 | 0~2147483647. 같은 클립에서 해상도나 길이를 비교할 때는 고정하고, 무작위 결과를 원하면 0을 보내지 말고 필드를 빼세요. |
요금
새 구간의 초 수만큼, 선택한 해상도로 과금합니다. 보낸 원본 클립은 과금되지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.045 / 초 |
| $0.09 / 초 |
| $0.135 / 초 |
활용 사례
너무 일찍 끝난 샷을 늘릴 수 있습니다. 라벨이 카메라를 향하기 전에 멈춘 제품 턴테이블이나 인물이 문에 닿기 전에 끊긴 걷기 장면이 그렇습니다. 몇 초 연장하고 남은 움직임만 적으세요.
더 긴 시퀀스를 단계별로 쌓을 수 있습니다. 첫 샷을 만들고 연장한 다음, 이어 붙인 결과를 다시 연장합니다. 각 단계는 추가한 초만 과금합니다. 모든 단계가 프레임 한 장에서 시작하므로 다음 단계를 쌓기 전에 이음매를 확인하세요.
프롬프트 가이드 및 실전 팁
장면 전체가 아니라 다음 한 박자를 적으세요. 누가 어디에 있는지는 프레임이 이미 정하므로, 프롬프트에는 이어지는 동작, 카메라 움직임, 소리를 쓰세요. 클립이 끝난 카메라 표현, 예를 들어 느린 푸시인이나 고정 샷을 반복하면 이음매가 한 테이크처럼 읽힙니다. 프롬프트는 선택 사항이지만, 동작을 분명하게 한 줄 적으면 아무것도 적지 않을 때보다 움직임이 안정됩니다.
연장하기 전에 잘라 두세요. 모델이 보는 이미지는 마지막 프레임뿐이므로 흐릿하거나, 컷 도중이거나, 압축이 심한 끝부분은 그대로 이어지는 부분에 넘어갑니다. 먼저 깨끗하고 선명한 프레임에서 원본을 자르세요. 최대 60초의 MP4, MOV, WebM 원본을 받습니다.
해상도를 원본에 맞추세요. resolution은 새 구간을 생성할 때의 선명도만 정합니다. 원본의 해상도에 맞추고 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-2.5/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 레퍼런스에서 확인하세요.
