사용 가이드
Minimax H3 Max 숏폼 영상: API로 실측한 텍스트→비디오
역사적으로 남겨진 480P 가로형 클립, 그 ffmpeg 세로형 변환, 그리고 현재의 프레임 이미지 입력과 가격 책정 규칙.
MiniMax H3 Max는 순수 텍스트 생성 시 기본 가로형 캔버스를 사용합니다. 세로형 숏폼 영상을 생성하려면 프레임 이미지로 캔버스를 유도하거나 후반 작업 단계에서 출력을 변환해야 합니다. 아래 예시는 480P 가로형 클립에서 시작해 ffmpeg로 9:16으로 변환합니다.
이 프롬프트로 생성하기 → 이 예시는 6초와 480P를 선택했으며, 순수 텍스트 출력은 기본 가로형 캔버스를 사용합니다.
우리가 실제로 생성한 것
우리는 텍스트→비디오 모드로 이 완전히 동일한 프롬프트를 minimax-h3-max에 전송했습니다:
한 플로리스트의 두 손이 햇빛이 비치는 marble 카운터 위에서 갈색 크라프트지로 라넌큘러스와 유칼립투스 꽃다발을 감싸고,
그다음 삼베 끈으로 깔끔한 리본을 묶는다; 부드러운 아침 창가 빛, 얕은 심도, 클로즈업 세로형 구도,
따뜻하고 포근한 분위기, 부드럽게 바스락거리는 종이의 움직임
이 프롬프트로 생성하기 → 6초와 480P를 선택합니다.
요청 본문:
{
"model": "minimax-h3-max",
"input": {
"prompt": "한 플로리스트의 두 손이 햇빛이 비치는 marble 카운터 위에서 갈색 크라프트지로 라넌큘러스와 유칼립투스 꽃다발을 감싸고,\n그다음 삼베 끈으로 깔끔한 리본을 묶는다; 부드러운 아침 창가 빛, 얕은 심도, 클로즈업 세로형 구도,\n따뜻하고 포근한 분위기, 부드럽게 바스락거리는 종이의 움직임",
"duration": 6,
"resolution": "480P",
"aspect_ratio": "9:16"
}
}
우리는 9:16을 요청했습니다. 다음은 API가 반환한 실제 출력이며, 아무런 편집 없이 바이트 단위로 그대로 제시합니다:
이 역사적으로 남겨진 480P 출력의 크기는 832×480입니다. 요청에 9:16 값이 있었음에도 불구하고 기본 가로형 캔버스를 사용했습니다. 이는 크기가 1344×768인 최신 768P 샘플과 다릅니다.
순수 텍스트 생성은 기본 가로형 캔버스를 사용합니다
HiAPI의 모델 설명에는 "순수 텍스트 생성은 기본 가로형 캔버스를 사용합니다"라고 되어 있습니다. 위의 원본 요청은 이 동작을 따랐습니다. 프롬프트가 세로형 구도를 묘사했고 요청에 aspect_ratio: "9:16"이 포함되어 있었음에도 소스 클립은 가로형이었습니다.
다른 캔버스가 필요하면 원하는 종횡비의 first_frame_image 또는 last_frame_image를 제공하세요. 프레임 이미지는 aspect_ratio와 상호 배타적이므로, 둘 중 하나의 프레임 필드를 사용할 때는 aspect_ratio를 생략해야 합니다. 또한 가로형 소스를 유지하고 아래처럼 생성 후 자르거나 채워 넣을 수도 있습니다.
ffmpeg 명령 한 줄로 세로형으로 변환
가로형 프레임을 9:16으로 자르면 꽃다발의 절반이 잘려 나갑니다. 그래서 우리는 흐린 배경의 필러박스(레터박스의 세로형) 방식으로 바꿨습니다. 소스 소재의 강하게 흐린 복사본을 세로형 캔버스를 채울 만큼 확대한 뒤, 원본 프레임을 그 위에 중앙 정렬로 겹쳐 놓습니다.
ffmpeg -y -i video.mp4 -filter_complex "\
[0:v]scale=720:1280:force_original_aspect_ratio=increase,crop=720:1280,gblur=sigma=20[bg];\
[0:v]scale=720:-1[fg];\
[bg][fg]overlay=(W-w)/2:(H-h)/2[out]" \
-map "[out]" -c:v libx264 -pix_fmt yuv420p -movflags +faststart video_vertical.mp4
한 번의 처리로 재렌더링 없이 화면 내용을 하나도 잃지 않습니다. 다음은 결과입니다. 같은 클립이 이제 진짜 720x1280 세로형 파일이 되었습니다:
이것이야말로 Reels, Shorts 또는 TikTok에 실제로 게시하게 될 버전입니다.
가격: 이런 클립 한 편에 실제로 얼마가 드는가
Minimax H3 Max는 출력 초 단위로 과금하며, 해상도에 따라 등급이 나뉩니다(hiapi 가격 페이지에서 확인):
- 480P — 초당 $0.072
- 768P — 초당 $0.115
길이 범위는 5–15초입니다. 현재 요금 기준으로 6초 480P 요청의 영상 예산은 $0.432이며, 6초 768P는 $0.69입니다. 생성 초 단위로 예산을 잡고, 작업 청구 기록에서 최종 청구 금액을 확인하세요.
동일한 길이에서 768P 비용은 480P의 약 1.60배입니다. 480P로 훅과 구도를 테스트하고, 선택한 숏을 768P로 렌더링하세요. 성공한 480P 초안 네다섯 번은 같은 길이의 768P 클립 한 편보다 여전히 비쌉니다.
자주 묻는 질문
Minimax H3 Max는 세로형 영상을 직접 생성할 수 있나요?
순수 텍스트 생성은 기본 가로형 캔버스를 사용합니다. 9:16이 필요하면 해당 비율의 프레임 이미지를 사용하고 aspect_ratio를 생략하거나, 자르기·흐림 채우기 오버레이로 가로형 출력을 변환하세요.
6초 클립에 얼마가 드나요? 480P는 $0.432($0.072/초 × 6초), 768P는 $0.69($0.115/초 × 6초)입니다.
가격 외에 480P와 768P의 차이는 무엇인가요? 768P는 더 높은 충실도의 등급으로 초당 비용이 480P의 약 1.6배입니다. 최종 게시용 렌더링에는 가치가 있지만, 프롬프트와 구도를 테스트하기에는 너무 사치스럽습니다.
이미지→비디오로 이 방향 문제를 피할 수 있나요?
API 문서는 프레임 이미지로 출력 캔버스를 결정하는 것을 지원합니다. first_frame_image 또는 last_frame_image를 제공하고 aspect_ratio를 생략하세요. 이 문서의 영상은 순수 텍스트 소스와 그 ffmpeg 변환을 보여 주는 것이며, 이미지→비디오 샘플이 아닙니다.
직접 해 보기
코드를 작성하기 전에 프롬프트를 테스트하고 싶다면 Minimax H3 Max 모델 페이지에서 온라인 Playground를 제공하며, Minimax H3 Max API 가이드는 인증과 전체 요청/응답 구조를 끝까지 설명합니다.
이 프롬프트로 생성하기 → 먼저 6초 480P 소스 소재를 생성한 뒤, 위의 ffmpeg 변환으로 세로형 결과물을 얻으세요.
관련 글
모든 아티클 보기 →-
사용 가이드
seedream-5.0-pro/image-to-image 시작 가이드: 기능, 가격 및 연동 핵심 포인트
ByteDance 이미지 편집 모델의 기능 경계, 과금 방식 및 엔지니어링 연동 실무
-
사용 가이드
seedream-5.0-pro 텍스트-이미지 생성 입문 가이드: 능력 경계, API 연동 및 비용 관리
개발자를 위한 실무 관점: 파라미터 핵심부터 장당 $0.05 비용 추정까지
-
사용 가이드
Hailuo 2.3 Fast 이미지-투-비디오 입문 가이드: 성능 범위, 가격 및 연동 실무
개발자를 위한 MiniMax 이미지-투-비디오 모델 선택과 연동 핵심 포인트