HiAPI
블로그

사용 가이드

Minimax H3 Max 숏폼 영상: API로 실측한 텍스트→비디오

역사적으로 남겨진 480P 가로형 클립, 그 ffmpeg 세로형 변환, 그리고 현재의 프레임 이미지 입력과 가격 책정 규칙.

Sep 11, 2026
Minimax H3 Max 숏폼 영상: API로 실측한 텍스트→비디오

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 변환으로 세로형 결과물을 얻으세요.

영구 AI 아티팩트로 빌드 시작하기

API 키를 받아 태스크 기반의 하나의 API로 이미지, 비디오, 오디오 모델을 호출하세요.

API 문서 보기