minimax/h3/reference-to-video28크레딧부터 / 5초 영상· 레퍼런스로 영상 만들기

MiniMax H3 reference-to-video는 번호 붙은 레퍼런스 이미지 최대 9장으로 샷 하나를 이끌며 캐릭터·의상·장소를 유지합니다. 768p·2k의 4~15초에 오디오가 생성됩니다.

POST /jobs/createTask에서 모델 이름을 minimax/h3/reference-to-video(으)로 지정하면 호출할 수 있습니다. 28크레딧/ 5초 영상부터(US$0.28). 새 계정에는 30크레딧이 지급되니 Playground에서 먼저 무료로 써 보세요.

  • 동영상 만들기
  • 이미지로 영상 만들기
  • 레퍼런스로 영상 만들기
  • 영상 이어 만들기
  • 최대 2K
  • 4–15초
  • 시작·끝 프레임
  • 참조 이미지 최대 9장
  • 화면비 6종

이 가이드는 당분간 영어로만 제공됩니다. →

요청 파라미터

파라미터필수설명
aspect_ratio아니요화면 모양: 가로, 정사각형, 세로. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 기본값: 16:9
duration_seconds아니요클립 길이. 초 단위로 요금이 붙습니다. ≥ 4 · ≤ 15 · 기본값: 5
enable_prompt_expansion아니요짧은 프롬프트에 모델이 디테일을 덧붙입니다. false · 기본값: false
prompt예Refer to the references by number and describe the shot they should produce.
reference_audio_urls아니요맞출 소리: 목소리, 음악, 리듬.
reference_image_urls예결과에 그대로 남길 인물, 의상, 장소의 참조 이미지.
reference_video_urls아니요움직임, 카메라, 스타일을 따라 할 참조 영상.
resolution아니요출력 크기. 클수록 선명하고 가격도 올라갑니다. 768p · 2k · 기본값: 768p

가격

가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.

옵션크레딧 /초≈ USD
resolution 768p5.55US$0.056
resolution 2K8.7US$0.087

작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 28크레딧/ 5초 영상(US$0.28)입니다.

실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.

API 빠른 시작

MiniMax H3 API를 3단계로 호출하기

  1. API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
  2. 요청 보내기. POST /jobs/createTask에 model은 minimax/h3/reference-to-video, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
  3. 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "minimax/h3/reference-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "reference_image_urls": [
      "https://media.popnow.ai/influencer/examples/ava.webp"
    ],
    "aspect_ratio": "16:9",
    "resolution": "768p",
    "duration_seconds": 5
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.

MiniMax H3 API 질문

MiniMax H3 API 요금은 얼마인가요?

MiniMax H3 가격은 가장 저렴한 레퍼런스로 영상 만들기 기준 28크레딧(US$0.28) / 5초 영상부터입니다. 옵션별 가격: 768p 5.55크레딧/초, 2K 8.7크레딧/초. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.

API에서 MiniMax H3의 모델 이름은 무엇인가요?

POST /jobs/createTask의 model 필드에 동영상 만들기: minimax/h3/text-to-video; 이미지로 영상 만들기: minimax/h3/image-to-video; 레퍼런스로 영상 만들기: minimax/h3/reference-to-video; 영상 이어 만들기: minimax/h3/video-extend을(를) 넣으세요.

MiniMax H3 영상은 얼마나 길게 만들 수 있나요?

클립당 최대 15초입니다. 더 긴 장면은 마음에 드는 클립의 마지막 프레임을 저장해 다음 클립의 시작 프레임으로 쓰십시오. 의상, 세트, 조명이 그대로 이어집니다.

MiniMax H3는 소리도 만드나요?

네. 앰비언스, 발소리, 음악, 대사가 영상과 같은 파일에 들어갑니다. 숏을 묘사하듯 원하는 소리를 프롬프트에 쓰십시오.

모든 클립에서 같은 캐릭터를 유지하려면 어떻게 하나요?

레퍼런스→영상을 쓰십시오. 얼굴, 의상, 방처럼 역할을 하나씩 맡긴 사진을 최대 9장 주고, 프롬프트에서는 Picture 1, Picture 2로 부르면 됩니다. 겹치는 사진 9장보다 선명한 사진 3~4장이 얼굴을 더 잘 유지합니다.

생성에 실패해도 요금이 나가나요?

아닙니다. 생성에 실패하면 그 작업을 위해 잡아 둔 금액이 바로 잔액으로 돌아갑니다.

MiniMax H3 API의 제한은 무엇인가요?

영상 길이: 4–15 s; 해상도: 768p · 2K; 화면 비율: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9; 참조 오디오: 3; 참조 이미지: 9. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.

코드 없이 MiniMax H3을(를) 써 볼 수 있나요?

네. Playground에서는 API 키 없이 PopNow 크레딧으로 MiniMax H3을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.

모든 MiniMax 모델

MiniMax H3 Max는 빠르게 생성하는 버전으로, 마지막 프레임은 선택해서 넣을 수 있지만 참조 모드와 2K는 없어요. H3는 만능 모델이에요.

MiniMax H3 더 알아보기