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