소개
Vidu Q4 Preview 영상 연장은 이미 가지고 있는 클립의 뒷이야기를 만듭니다. 클립을 video_url로 보내고, 다음에 일어날 일을 프롬프트로 적어 주세요. 클립의 마지막 프레임이 3~16초짜리 새 Vidu Q4 Preview 이미지 투 비디오 샷의 시작 프레임이 되고, 둘은 하나의 MP4로 이어집니다. 원본이 먼저, 연장분이 그다음이며 이음매에서 겹치는 프레임은 제거됩니다. 새 구간은 별도 파일로도 돌아오므로 계속 연장하거나 따로 편집할 수 있습니다.
핵심 기능 및 하이라이트
연속성은 마지막 프레임에서 나옵니다. 의상, 배경, 빛, 인물의 위치가 이어지는 것은 새 구간이 말 그대로 여러분의 마지막 프레임에서 시작하기 때문입니다. 움직임은 같은 방식으로 이어지지 않습니다. 모델이 보는 것은 클립 전체가 아니라 정지 이미지 한 장이므로, 속도나 방향이 그대로 유지될 거라 기대하지 말고 이어 가고 싶은 움직임을 적어 주세요.
하나의 파일과 새 부분 단독 파일이 함께 돌아옵니다. 이어 붙인 MP4는 원본 클립의 프레임 레이트와 화면 구성을 유지하며 검은 띠는 생기지 않습니다. 이음새를 맞추기 위해 화면 가장자리가 몇 퍼센트 정도 잘리거나 조정될 수 있습니다. 모델이 돌려준 영상의 화면 비율이 눈에 띄게 다르면 새 구간을 화면에 꽉 차게 확대해 가운데에 맞추고, 넘치는 부분은 잘라 냅니다. 파일은 H.264 MP4와 AAC 소리로 인코딩됩니다. 원본의 소리는 유지되고 새 구간에서 생성된 소리가 그 뒤를 잇습니다. 한쪽이 무음이면 무음으로 채워 이음매에서 화면과 소리가 어긋나지 않습니다. 출력의 두 번째 에셋은 새 구간만 담겨 있어 다음 연장이나 편집에 바로 쓸 수 있습니다.
그 밖의 모든 것은 Vidu Q4 Preview 이미지-투-비디오와 같습니다. 새 구간은 같은 경로에서 실행되며, 콘텐츠 범위와 초당 가격도 이미지-투-비디오 엔드포인트와 같습니다. 실패한 생성은 같은 방식으로 환불됩니다. 거절도 포함되며, 매우 강함 단계 요청은 거절되고 거절된 요청에는 과금되지 않습니다. 생성은 성공했지만 이어 붙이기 자체를 만들 수 없으면 작업은 실패하고 과금은 환불됩니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수, 최대 20,000자입니다. 다음에 일어날 일, 즉 이어지는 동작, 카메라 움직임, 소리를 적어 주세요. 1자 이상 · 20000자 이하 |
video_url | 예 | 이어 붙일 클립입니다. MP4, MOV, WebM으로 최대 60초. 1자 이상 |
resolution | 아니요 | 생성되는 새 구간의 선명도입니다. 540p, 720p, 1080p, 2k 또는 4k 중에서 고르며 기본값은 720p입니다. |
duration_seconds | 아니요 | 새 구간의 길이입니다. 3~16초의 정수로 지정하며 기본값은 5입니다. |
generate_audio | 아니요 | 기본값은 켜짐이며 새 구간에 생성된 소리가 붙습니다. 원본의 소리는 어느 쪽이든 그대로 유지됩니다. 기본값: |
enable_prompt_expansion | 아니요 | 기본값은 꺼짐입니다. 켜면 생성 전에 모델이 프롬프트를 고쳐 쓰고 확장합니다. 기본값: |
seed | 아니요 | 0~2147483647. 한 번에 한 항목만 바꿔 비교할 때는 고정하고, 다양한 결과를 원하면 비우세요. |
요금
새 구간의 초 단위로, 선택한 해상도에 따라 과금됩니다. 보낸 원본 클립은 과금되지 않습니다. 거부된 요청은 과금되지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.045 / 초 |
| $0.095 / 초 |
| $0.12 / 초 |
| $0.19 / 초 |
| $0.39 / 초 |
활용 사례
너무 일찍 끝난 샷을 늘릴 수 있습니다. 라벨이 카메라를 향하기 전에 멈춘 제품 턴테이블이나, 인물이 문에 닿기 전에 끊긴 걸음 장면이 그렇습니다. 몇 초만 연장하고 남은 움직임만 적으세요.
긴 시퀀스를 한 단계씩 쌓을 수 있습니다. 첫 샷을 만들어 연장하고, 이어 붙인 결과가 60초 원본 한도 안에 있는 동안 다시 연장하면 됩니다. 각 단계에서는 추가된 초만 과금됩니다. 모든 단계가 프레임 한 장에서 시작하므로 다음 단계를 쌓기 전에 이음매를 확인하세요.
프롬프트 가이드 및 실전 팁
장면 전체가 아니라 다음 한 박자를 적으세요. 누가 어디에 있는지는 프레임이 정하므로, 프롬프트는 이어지는 동작, 카메라 움직임, 소리에 쓰세요. 클립이 끝난 카메라 표현, 예를 들어 천천히 밀고 들어가기나 고정 샷을 반복하면 이음매가 한 테이크처럼 보입니다.
연장하기 전에 다듬으세요. 모델이 보는 것은 마지막 프레임뿐이라, 흐릿하거나 컷 중간이거나 압축이 심한 끝부분이 그대로 연장분에 이어집니다. 먼저 깨끗하고 선명한 프레임에서 잘라 주세요. 원본은 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": "vidu/q4-preview/video-extend",
"input": {
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"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 레퍼런스에서 확인하세요.
