소개
MiniMax H3 Singularity LoRA 영상 연장은 이미 가지고 있는 클립의 뒷이야기를 만듭니다. 클립을 video_url로 보내고 다음에 일어날 일을 프롬프트로 적습니다. 클립의 마지막 프레임이 3~15초짜리 새 MiniMax H3 Singularity LoRA 이미지→영상 샷의 시작 프레임이 되고, 둘은 MP4 하나로 합쳐집니다. 원본이 먼저, 이어진 부분이 그다음이며, 이음매에서 겹치는 프레임은 제거됩니다. 새 구간은 단독 파일로도 돌아오므로 계속 연장하거나 부분별로 따로 편집할 수 있습니다.
핵심 기능 및 하이라이트
연속성은 마지막 프레임에서 나옵니다. 새 구간이 말 그대로 마지막 프레임에서 시작하기 때문에 의상, 배경, 빛, 인물의 위치가 그대로 이어집니다. 움직임은 같은 방식으로 이어지지 않습니다. 모델이 보는 것은 클립 전체가 아니라 정지 이미지 한 장이므로, 속도와 방향이 그대로 유지될 것이라고 가정하지 말고 이어 가려는 움직임을 적으십시오.
파일 하나와 새 부분 단독 파일이 함께 돌아옵니다. 원본의 소리는 그대로 남고, 새 구간의 소리가 그 뒤에 이어집니다. 출력의 첫 번째 에셋은 합쳐진 클립(역할 video)이고, 두 번째는 새 구간만 담긴 파일(역할 segment)이어서 다음 연장이나 편집에 바로 쓸 수 있습니다. 이어 붙인 MP4는 원본 클립의 프레임 레이트와 화면 구성을 유지하며 검은 띠는 생기지 않습니다. 이음새를 맞추기 위해 화면 가장자리가 몇 퍼센트 정도 잘리거나 조정될 수 있습니다. 모델이 돌려준 영상의 화면 비율이 눈에 띄게 다르면 새 구간을 화면에 꽉 차게 확대해 가운데에 맞추고, 넘치는 부분은 잘라 냅니다.
나머지는 모두 MiniMax H3 Singularity LoRA 이미지→영상와 같습니다. 새 구간은 이미지→영상 엔드포인트와 같은 경로, 같은 콘텐츠 허용 범위, 같은 초당 요금으로 생성되며, 생성에 실패했을 때의 환불도 같습니다. 생성은 성공했지만 이어 붙이기만 만들지 못한 경우에도 작업은 실패로 처리되고 요금은 환불됩니다.
LoRA도 그대로 이어집니다. loras는 이미지→영상와 똑같이 동작합니다. 파일을 최대 세 개까지 각각 강도를 정해 지정하며, 새 구간에 적용됩니다. 원본 클립에 쓴 것과 같은 LoRA를 불러오면 이음매 앞뒤에서 스타일이 일관됩니다.
결말도 정할 수 있습니다. 목표 마지막 프레임으로 last_image_url을 추가하면 새 구간이 그 이미지에서 끝납니다. 고정되는 것은 결말이며, 중간의 움직임은 고정되지 않습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수입니다. 다음에 일어날 일, 즉 이어지는 동작과 카메라 움직임, 소리를 적습니다. 1자 이상 · 7000자 이하 |
video_url | 예 | 이어 갈 클립입니다. MP4, MOV, WebM으로 60초까지 가능합니다. 1자 이상 |
last_image_url | 아니요 | 선택 사항인 목표 마지막 프레임입니다. 새 구간이 이 이미지에서 끝납니다. |
resolution | 아니요 | 480p, 540p, 768p, 1080p 중에서 고르며 기본값은 480p입니다. 이음매가 자연스럽도록 원본의 해상도에 맞추십시오. |
duration_seconds | 아니요 | 새 구간의 길이입니다. 3~15 사이의 정수 초이고 기본값은 5입니다. |
loras | 아니요 | MiniMax H3용으로 학습된 {path, scale} 항목을 최대 세 개까지 지정하며, scale은 0~4이고 새 구간에 적용됩니다. 원본 클립에 쓴 LoRA를 다시 쓰면 이음매 앞뒤에서 스타일이 일관됩니다. 기본값: |
seed | 아니요 | 선택 사항이며 0~2147483647입니다. 한 번에 항목 하나만 바꿔 비교할 때는 고정하고, 다양한 결과를 원하면 비워 두십시오. |
요금
과금은 선택한 해상도에서 새 구간의 초 단위로 이루어집니다. 보내는 원본 클립은 과금되지 않습니다. LoRA를 불러오는 데는 별도 요금이 없습니다.
| 사양 | 요금 |
|---|---|
| $0.0625 / 초 |
| $0.09375 / 초 |
| $0.125 / 초 |
| $0.25 / 초 |
활용 사례
너무 일찍 끝난 샷을 늘릴 수 있습니다. 라벨이 카메라를 향하기 전에 멈춘 제품 턴테이블이나, 인물이 문에 닿기 전에 끊긴 걸음 장면이 그 예입니다. 몇 초만 연장하고 남은 움직임만 적으십시오.
더 긴 시퀀스를 한 단계씩 쌓을 수 있습니다. 첫 샷을 만들어 연장하고, 합쳐진 결과를 다시 연장하십시오. 각 단계는 더해진 초만 과금합니다. 단계마다 프레임 한 장에서 시작하므로, 다음 단계를 쌓기 전에 이음매를 확인하십시오.
프롬프트 가이드 및 실전 팁
장면 전체가 아니라 다음 한 박자를 적으십시오. 누가 어디에 있는지는 프레임이 이미 정하므로, 프롬프트는 이어지는 동작과 카메라 움직임, 소리에 쓰십시오. 클립이 끝난 카메라 표현, 예를 들어 느린 푸시인이나 고정 샷을 반복하면 이음매가 한 테이크처럼 읽힙니다.
연장하기 전에 먼저 자르십시오. 모델이 보는 것은 마지막 프레임뿐이므로, 흐릿하거나 컷 중간이거나 압축이 심한 끝부분은 그대로 이어지는 구간에 들어갑니다. 먼저 깨끗하고 선명한 프레임에서 원본을 자르십시오. 원본은 60초까지, MP4, MOV, WebM을 지원합니다.
해상도를 일관되게 유지하십시오. 이음매가 자연스럽도록 원본의 해상도에 맞추고, 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": "minimax/h3-singularity-lora/video-extend",
"input": {
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "480p",
"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 레퍼런스에서 확인하세요.
