MiniMax H3 Max Turbo 시작 가이드: 텍스트 투 비디오, 첫/마지막 프레임 이미지 투 비디오, 파라미터와 가격

MiniMax H3 Max Turbo는 H3 Max의 고속 버전으로, HiAPI에서 두 가지 호출 ID를 제공합니다: minimax-h3-max-turbo/text-to-video(텍스트 투 비디오)와 minimax-h3-max-turbo/image-to-video(첫 프레임 이미지 투 비디오, 마지막 프레임 추가 가능). 1회 1–15초, 480P / 768P / 1080P 세 가지 화질, 초 단위 과금입니다. 이 글에서는 두 ID를 어떻게 선택하고, 파라미터를 어떻게 입력하며, 가격이 어떻게 계산되는지 설명합니다.

두 ID 선택 방법

• 텍스트 설명만 있는 경우: text-to-video를 사용하며, 필수 입력은 prompt뿐이고 화면 비율은 aspect_ratio로 지정합니다.
• 이미 화면이 있는 경우: image-to-video를 사용하며, prompt와 image_url(첫 프레임)이 필수입니다. end_image_url을 마지막 프레임으로 추가로 지정하면 모델이 두 프레임 사이의 움직임을 채워 넣습니다.
• 이미지 투 비디오의 출력 화면 비율은 첫 프레임 이미지를 따르며 aspect_ratio 파라미터가 없습니다. 세로 화면을 원하면 세로 이미지를 전달하고, 첫/마지막 프레임의 비율을 최대한 일치시키세요.

파라미터

• resolution: 480P / 768P / 1080P, 기본값 768P. 1080P는 768P 화면을 정교화하여 얻은 결과이며, 원본 생성은 최대 768P까지입니다.
• duration: 1–15초, 기본값 5, 소수점 입력 가능. 실제 출력은 입력한 길이보다 최대 약 0.7초 더 길 수 있습니다. 예를 들어 5초를 입력하면 약 5.2초 길이의 클립이 생성됩니다.
• aspect_ratio(텍스트 투 비디오 전용): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 기본값 16:9. 예를 들어 768P 3:4는 768×1024, 768P 21:9는 1536×672로 출력됩니다.
• prompt_expansion_mode: 프롬프트 확장. disabled는 원문 그대로 사용, balanced(기본값)는 약 1초 만에 재작성, quality는 최대 약 30초를 들여 더 세밀하게 작성합니다.
• target_audio_url: 선택 사항. 최소 2초, 최대 15MB 이하의 오디오를 완성본 음성 트랙으로 전달하며, 영상보다 긴 부분은 잘립니다. 사용 시 duration을 최소 2 이상 입력하세요.
• seed: 선택 사항. 동일한 결과를 재현하려면 고정하고, 나머지 파라미터도 동일하게 유지하세요.
• 요청마다 영상 1개를 생성합니다. 이 두 ID는 참조 이미지로 캐릭터 고정, 영상 이어 만들기, 영상 편집을 제공하지 않습니다.

호출 예시

작업 제출:

curl https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-max-turbo/image-to-video",
    "input": {
      "prompt": "자전거 타는 사람이 가로등 근처에서 속도를 줄이고 뒤를 돌아보며, 따뜻한 네온 불빛 속에 빗줄기가 흐르고, 천천히 푸시인",
      "image_url": "https://example.com/first-frame.png",
      "resolution": "768P",
      "duration": 5
    }
  }'

data.taskId가 반환되면 GET https://api.hiapi.ai/v1/tasks/<taskId>로 폴링합니다. status가 success가 되면 영상 주소는 data.output[0].url에 있습니다. 5초 768P는 보통 십여 초 안에 결과가 나옵니다. 결과 링크에는 유효기간이 있으며(필드 expireAt), 장기 보관이 필요하면 직접 다운로드하여 저장하세요.

가격

• 480P: 초당 $0.025.
• 768P: 초당 $0.04.
• 1080P: 초당 $0.08.
• 요청에 입력한 duration 기준으로 과금되며 두 ID 가격은 동일합니다. 예를 들어 768P 5초: 5 × 0.04 = $0.20; 1080P 10초: $0.80.
• 성공적으로 생성된 작업에만 과금되며, 작업 실패 시 전액 환불됩니다.

프롬프트 작성법

• 텍스트 투 비디오는 「주체 + 장면 + 동작 + 카메라 움직임 + 조명과 분위기」 순서로 명확하게 작성하세요.
• 이미지 투 비디오는 첫 프레임에서 구도가 이미 정해졌으므로 화면에 이미 있는 내용은 줄이고, 「누가 어떻게 움직이는지, 카메라가 어떻게 움직이는지, 몇 초 안에 완료되는지」를 충분히 작성하세요. 예: 「카메라가 천천히 다가가며, 인물이 3초에 뒤를 돌아본다」.
• 먼저 480P와 짧은 길이로 동작과 카메라 워크를 시험해 보고, 만족하면 768P 또는 1080P로 출력하세요. 1080P 단가는 480P의 3.2배입니다.