소개
MiniMax H3 비디오 연장은 이미 가지고 있는 클립을 이어서 생성합니다. 클립을 video_url로 보내고 다음에 일어날 일을 프롬프트로 쓰십시오. 클립의 마지막 프레임이 MiniMax H3 새 image-to-video 샷(4~15초)의 시작 프레임이 되고, 둘은 하나의 MP4로 이어집니다. 원본이 먼저, 그다음 새 구간이 오며 이음새에서 겹치는 프레임은 제거됩니다. 새 구간은 별도 파일로도 돌아오므로 계속 연장하거나 조각을 따로 편집할 수 있습니다.
핵심 기능 및 하이라이트
연속성은 마지막 프레임에서 나옵니다
새 구간이 말 그대로 마지막 프레임에서 시작하므로 의상, 세트, 조명, 모두의 위치가 이어집니다. 움직임은 같은 방식으로 이어지지 않습니다. 모델은 클립 전체가 아니라 정지 이미지 한 장을 보기 때문입니다. 속도나 방향이 유지될 것이라고 가정하지 말고, 이어 가려는 움직임을 직접 쓰십시오.
이어 붙인 파일 하나와 새 조각 단독 파일
이어 붙인 MP4는 원본 클립의 프레임 레이트와 화면 구성을 유지하며 검은 띠는 생기지 않습니다. 이음새를 맞추기 위해 화면 가장자리가 몇 퍼센트 정도 잘리거나 조정될 수 있습니다. 모델이 돌려준 영상의 화면 비율이 눈에 띄게 다르면 새 구간을 화면에 꽉 차게 확대해 가운데에 맞추고, 넘치는 부분은 잘라 냅니다. 새 구간에는 같은 처리에서 생성된 소리가 함께 붙고, 원본의 소리도 그대로 유지되며, 이음새는 1초도 안 되는 시간에 부드럽게 섞입니다. 한쪽이 무음이면 다른 쪽이 무음으로 채워집니다. 출력의 두 번째 에셋은 role이 segment인 새 구간 단독 파일로, 추가 연장이나 편집기에 바로 쓸 수 있습니다.
선택 사항인 종료 프레임
last_image_url은 선택 사항입니다. 이미지를 보내면 새 구간이 그 이미지에서 마무리되고, 생략하면 결말은 자유입니다. 종료 프레임은 결말만 잡아 주며, 구간이 길수록 중간은 그 프레임에서 더 멀어질 수 있습니다. 4초 구간은 768p에서만 선택할 수 있고, 2k는 5초 이상이 필요합니다.
나머지는 모두 MiniMax H3 image-to-video입니다
새 구간은 image-to-video 엔드포인트와 같은 경로, 같은 콘텐츠 범위, 같은 초당 요금으로 실행되며, 생성 실패 시 환불도 같습니다. 생성은 성공했지만 이어 붙이기를 만들 수 없으면 작업이 실패 처리되고 청구액은 환불됩니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수입니다. 다음에 일어날 일, 즉 이어지는 동작, 카메라 움직임, 소리를 쓰십시오. 1자 이상 · 7000자 이하 |
video_url | 예 | 이어 갈 클립입니다. MP4, MOV, WebM, 최대 60초. 1자 이상 |
last_image_url | 아니요 | 선택 사항인 목표 종료 프레임입니다. 새 구간이 이 이미지에서 끝납니다. |
resolution | 아니요 | 새 구간의 해상도로 768p 또는 2k이며 기본값은 768p입니다. 둘 다 네이티브 렌더입니다. |
duration_seconds | 아니요 | 새 구간의 길이(정수 초)로 4~15초이며 기본값은 5초입니다. 4초 구간은 768p에서만 선택할 수 있고, 2k는 5초 이상이 필요합니다. |
요금
선택한 해상도로 새 구간의 초 단위로 청구되며, 보낸 원본 클립은 청구되지 않습니다. 생성에 실패하거나 이어 붙이기를 만들 수 없는 경우 전액 환불됩니다.
| 사양 | 요금 |
|---|---|
| $0.037 / 초 |
| $0.058 / 초 |
활용 사례
너무 일찍 끝난 샷 늘리기
라벨이 카메라를 향하기 전에 멈추는 제품 턴테이블, 피사체가 문에 닿기 전에 끊기는 걷기 장면 등입니다. 몇 초 연장하고 남은 움직임만 쓰십시오.
긴 시퀀스를 단계별로 만들기
한 번의 요청으로는 최대 15초까지 생성됩니다. 더 가려면 첫 샷을 만들고 연장한 다음, 이어 붙인 결과를 다시 연장하십시오. 각 단계에서는 추가된 초만 청구됩니다. 각 단계가 한 장의 프레임에서 시작하므로 다음 단계를 쌓기 전에 이음새를 확인하십시오.
프롬프트 가이드 및 실전 팁
장면 전체가 아니라 다음 박자를 쓰십시오
누가 어디에 있는지는 프레임이 이미 정하므로, 프롬프트는 이어지는 동작, 카메라 움직임, 소리에 쓰십시오. 클립이 끝날 때의 카메라 표현(느린 푸시 인, 고정 샷 등)을 반복하면 이음새가 하나의 테이크처럼 읽힙니다.
연장하기 전에 먼저 자르십시오
모델이 보는 것은 마지막 프레임뿐이므로 흐릿한 끝, 동작 중간에 잘린 끝, 심하게 압축된 끝은 그대로 이어지는 구간에 넘어갑니다. 먼저 선명한 프레임에서 원본을 자르십시오. 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/video-extend",
"input": {
"duration_seconds": 5,
"enable_prompt_expansion": false,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p",
"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 레퍼런스에서 확인하세요.
