MiniMax
MiniMax H3 Max Turbo
minimax-h3-max-turbo/text-to-video
MiniMax의 속도 최적화 모델 비디오 모델로, 텍스트→비디오와 이미지→비디오(첫 프레임 및 선택적 마지막 프레임 지정 가능)를 지원하며, 1회 생성으로 1~15초, 480P~1080P 클립을 만들어 마케팅 숏폼 영상의 빠른 초안 작성과 스토리보드 사전 시연에 적합합니다
minimax-h3-max-turbo/text-to-video 사용해 보기
입력
작품 갤러리
모든 작품 보기출력
video가격
minimax-h3-max-turbo/text-to-video per second
| 사양 | 단가 |
|---|---|
| 480P | $0.025 |
| 768P | $0.040 |
| 1080P | $0.080 |
포지셔닝 소개
이 모델은 텍스트를 받아 영상 클립을 바로 생성하는 문생비디오 모델입니다. 한 번에 1~15초 분량의 화면을 생성할 수 있으며, 해상도는 480P, 768P, 1080P 세 단계 중 선택할 수 있고 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 여섯 가지 화면 비율을 지원합니다. 프롬프트는 최대 50000자까지 입력할 수 있으며 랜덤 시드를 지정해 재현할 수도 있습니다. 마케팅 숏폼 영상의 빠른 대량 제작, 스토리보드 사전 시연, 소셜 미디어 콘텐츠 제작 등 동적 화면을 처음부터 생성해야 하는 상황에 적합합니다.
핵심 하이라이트
- 최대 15초 텍스트 직출 영상 — 길이는 1~15초 사이에서 설정할 수 있으며, 실제 완성 영상은 요청보다 최대 약 0.7초 길 수 있어 독립적인 숏폼 클립 제작에 적합합니다.
- 세 단계 해상도와 여섯 가지 화면 비율 — 480P, 768P, 1080P를 필요에 따라 선택하고 가로·세로 등 여섯 가지 비율이 주요 게시 환경을 커버합니다.
- 프롬프트 확장 강도 조절 가능 — disabled는 재작성을 건너뛰고, balanced는 약 1초 만에 반환되며, quality는 최대 약 30초를 들여 더 풍부한 프롬프트를 만듭니다.
기능 설명
텍스트 설명으로 영상 생성: 텍스트 프롬프트 한 편을 입력하면 영상 클립을 만들어내며, 프롬프트는 최대 50000자까지 지원합니다. 기존 소재가 없고 화면을 처음부터 구성해야 하는 상황에 적합합니다.
길이 및 해상도 선택 가능: 요청마다 1~15초 중 하나의 길이를 고르고 480P, 768P, 1080P 중 한 단계 해상도를 선택해 용도에 맞게 세부 묘사와 규격의 균형을 맞춥니다.
여섯 가지 화면 비율: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 중 하나로 출력할 수 있어 가로 재생, 정사각형 피드, 세로형 숏폼 등 다양한 지면에 맞출 수 있습니다.
시드 및 프롬프트 확장 제어: 랜덤 시드를 지정해 생성 시작점을 고정할 수 있고, 프롬프트 확장은 비활성화, 균형, 고품질 세 가지 모드를 지원해 생성 속도에 맞춰 선택할 수 있습니다.
적용 시나리오
- 마케팅 팀의 다중 버전 숏폼 빠른 제작 — 제품 판매 포인트나 캠페인 주제를 텍스트로 입력해 여러 후보 클립을 대량 생성하고, 소셜 미디어 게시 전 소재 비교 선별에 활용합니다.
- 소셜 크리에이터의 세로형 콘텐츠 제작 — 9:16 비율과 짧은 길이로 화면 내용을 설명해 숏폼 플랫폼에 바로 게시할 수 있는 클립 소재를 출력합니다.
- 영상 사전 제작 스토리보드 동적 시연 — 스토리보드 대본 텍스트에 따라 동적 스케치를 생성해 감독과 아트 담당자가 정식 제작 전 촬영 리듬과 구도를 확인하도록 돕습니다.
- 광고 크리에이티브 콘셉트 검증 — 간결한 텍스트로 크리에이티브 콘셉트를 설명하고 짧은 길이로 빠르게 영상을 만들어 최종 완성본이 아닌 동적 방향성을 고객에게 제시하는 데 활용합니다.
제한 사항 및 선택 가이드
길이 범위는 1~15초이며 실제 완성 영상은 요청보다 최대 약 0.7초 길 수 있습니다. 1080P는 네이티브 768P 소스에서 잠재적으로 정교화한 것으로 네이티브 생성이 아닙니다. 프롬프트는 최대 50000자입니다. 이 모델은 텍스트로 영상을 생성하는 것만 지원하며 참조 이미지, 참조 클립, 참조 오디오로 캐릭터와 스타일 일관성을 유지할 수 없고 영상 편집 기능도 갖추지 않습니다.
새소식
변경 이력 보기 →- 새 모델 MiniMax H3 Max Turbo 출시: 텍스트-비디오 및 첫/마지막 프레임 이미지-비디오
자주 묻는 질문
모든 질문 보기 →-
이 모델의 1080P는 기본 생성인가요?
기본 생성이 아니며, 1080P는 768P 소스에서 잠재 공간 정밀 보정을 거쳐 얻은 결과입니다. 모델이 기본 생성하는 최고 해상도는 768P입니다. 화면 디테일에 대한 엄격한 요구 사항이 있다면 768P 기본 생성 기준으로 평가하거나, 2K 마스터를 지원하는 해상도 옵션으로 전환하는 것을 권장합니다.
-
이미지 기반 영상 생성에서 참조 이미지로 캐릭터를 고정할 수 있나요?
현재 참조 이미지 기반 영상 생성은 지원되지 않습니다. image_url은 시작 프레임으로만 사용되며, 생성 캔버스가 이 이미지를 따르기 때문에 참조 이미지, 참조 클립 또는 오디오로 캐릭터와 스타일을 고정할 수 없습니다. 캐릭터 일관성이 필요한 경우에는 참조 이미지 기반 영상 생성을 지원하는 티어를 사용해야 합니다.
-
첫 프레임과 마지막 프레임을 어떻게 설정해야 카메라 착지점을 제어할 수 있나요?
image_url로 첫 프레임을 지정하고, 선택 사항인 end_image_url로 마지막 프레임을 지정하면 모델이 두 프레임 사이의 움직임을 보간합니다. 첫 프레임이 전체 출력 캔버스를 결정하므로 마지막 프레임의 구도와 비율은 첫 프레임과 비슷해야 하며, 그렇지 않으면 보간 시 변형이 발생하기 쉽습니다.
-
생성된 영상 길이가 15초를 넘을 수 있나요?
한 번 생성 시 최대 15초이며, 한 번에 더 긴 클립을 만들 수는 없습니다. 실제 출력은 입력한 duration보다 약 0.7초 길 수 있습니다. 더 긴 완성본이 필요하면 장면별로 나누어 생성한 뒤 이어 붙이세요.
생성 작업 제출
https://api.hiapi.ai/v1/tasks 헤더
Authorizationstring필수계정 API 키. 모든 요청에 필수입니다. 예: Bearer YOUR_HIAPI_API_KEY. API 키 받기
Content-Typestring선택요청 본문은 항상 JSON으로 파싱됩니다. 전송 시 application/json(charset 포함 가능)만 허용되며, 다른 값은 415를 반환합니다. 예: application/json.
Idempotency-Keystring선택멱등 키. 최대 255바이트. 같은 계정에서 같은 키의 재시도는 태스크를 한 번만 생성하며, 재전송 시 최초의 taskId를 반환합니다.
네트워크 타임아웃이나 클라이언트 자동 재시도 시 같은 키로는 태스크를 한 번만 생성하고 이중 과금되지 않습니다(범위 = API 키의 계정). 업무 고유 식별자(예: "order-42")를 키로 사용할 것을 권장합니다. 같은 키 재전송 시 최초 taskId를 반환하며, 키는 첫 제출 후 24시간 뒤 만료됩니다. 자세한 시나리오 표는 통합 비동기 API 소개 페이지를 참고하세요.
본문
modelstring필수현재 고정 값: minimax-h3-max-turbo/text-to-video
routestring선택현재 고정 값: default
inputobject필수
minimax-h3-max-turbo/text-to-video 및 루트 default의 비즈니스 파라미터 객체. 아래 파라미터 표를 참조하세요.
seedinteger선택생성 결과의 무작위성을 제어하는 데 사용되는 랜덤 시드입니다. 생략하면 시스템이 자동으로 시드를 무작위로 선택합니다.
promptstring필수minLength 1maxLength 50000비디오 생성을 위한 텍스트 프롬프트로, 원하는 화면 내용을 설명합니다.
durationnumber선택기본값: 5min 1max 15비디오 길이(초)로, 1초에서 15초까지 설정할 수 있으며 기본값은 5초입니다. 실제 출력은 요청한 값보다 약 0.7초 더 길 수 있습니다. target_audio_url을 사용하는 경우 길이를 최소 2초로 설정해야 합니다.
resolutionstring선택기본값: "768P"생성 해상도로, 480P, 768P 또는 1080P 중 선택할 수 있으며 기본값은 768P입니다. 1080P는 네이티브 768P 소스에서 잠재 공간 정제를 수행한 결과이며 네이티브 생성은 아닙니다.
480P768P1080Paspect_ratiostring선택기본값: "16:9"생성 비디오의 화면 비율로, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 중 선택할 수 있으며 기본값은 16:9입니다.
21:916:94:31:13:49:16target_audio_urlstring선택선택 사항으로, 최소 2초, 최대 15MB의 오디오 URL을 제공하여 생성되는 비디오의 오디오 트랙을 고정합니다.
prompt_expansion_modestring선택기본값: "balanced"생성 전 프롬프트 재작성에 투입하는 강도로, 기본값은 balanced입니다. disabled는 프롬프트 확장을 건너뜁니다. balanced는 약 1초 만에 반환됩니다. quality는 최대 약 30초를 들여 더 풍부한 프롬프트를 생성합니다.
disabledbalancedqualitycallbackobject선택
종료 상태 알림 설정. 생략하면 콜백이 전송되지 않으며 호출 측에서 폴링합니다.
생성 시 callback.url을 지정하면 태스크 종료 시 HiAPI가 서비스로 POST하여 폴링이 필요 없습니다. 콜백 본문은 태스크 상세와 동일한 구조입니다. 서명 검증·재시도·멱등에 대한 자세한 내용은 통합 비동기 API 소개 페이지의 콜백 설명을 참고하세요.
urlstring필수callback 사용 시 필수. 태스크 종료 후 이 URL로 POST됩니다. 유효한 http(s) URL이어야 합니다.
whenstring선택기본값: "final"현재는 final만 지원(success / fail 모두 알림).
finalstoragestring선택기본값: "temp"산출물 저장 등급: temp(기본·약 7일) 또는 persistent(장기 보관·용량 과금). 잔액 부족이나 저장 한도 초과 시 자동으로 temp로 강등됩니다. 실제 적용된 등급은 태스크 상세 응답에서 확인할 수 있습니다.
temppersistent요청 예시
# 비동기 태스크 제출. 성공 시 즉시 taskId 반환(생성 완료 대기 없음)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-max-turbo/text-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "768P",
"aspect_ratio": "16:9",
"prompt_expansion_mode": "balanced"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "minimax-h3-max-turbo/text-to-video",
input: {
"prompt": "…",
"duration": 5,
"resolution": "768P",
"aspect_ratio": "16:9",
"prompt_expansion_mode": "balanced"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "minimax-h3-max-turbo/text-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "768P",
"aspect_ratio": "16:9",
"prompt_expansion_mode": "balanced"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} 작업 상세 조회
https://api.hiapi.ai/v1/tasks/:id 응답 필드
taskIdstring필수태스크 ID. 접두사는 항상 tk-hiapi-.
modelstring필수확인된 전체 모델명. route 파라미터로 제출한 태스크는 base@route(예: gpt-image-2/text-to-image@ext)를 반환하며, 그 외에는 제출 시의 모델명과 동일합니다.
routestring선택route 파라미터를 명시해 제출한 태스크에만 나타나며, 제출한 값을 그대로 반환합니다.
statusstring필수태스크 상태.
queued 대기 중, 아직 시작되지 않음.
handling 처리 중.
archiving 처리 완료, 산출물 준비 중.
success 종료: 완료. 산출물 사용 가능(output 반환).
fail 종료: 실패(error 반환).
제출 후 status로 판단합니다: success와 fail이 종료 상태이며 나머지는 비종료입니다. 1~3초 간격으로 종료까지 폴링하세요. 성공 시 output[].url에서 산출물을 다운로드하고 expireAt 전에 옮기세요. 장기 보관이 필요하면 생성 시 storage: "persistent"를 사용하세요.
creatednumber필수태스크 생성 시각(Unix 초).
completednumber필수종료 상태가 된 Unix 초. 비종료 상태에서는 0.
outputarray선택
status == success일 때만 나타납니다. 산출물 목록 — 항상 배열이며, 하나의 태스크에서 여러 type을 동시에 반환할 수 있습니다(예: video + first_frame).
Array [ object ]
배열 항목
urlstring필수산출물 URL. 바로 다운로드할 수 있습니다.
typestring필수현재 가능한 값: video, image, audio, first_frame, last_frame, thumbnail. 이후 확장될 수 있습니다.
expireAtnumber필수산출물 접근 가능 기한(Unix 초). 만료 전에 다운로드하거나 이전하세요.
errorobject선택
status == fail일 때만 나타납니다.
codestring필수비즈니스 오류 코드.
messagestring필수오류 설명.
응답 예시
성공
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} 처리 중(비종료)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} 실패
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} 아티클
모든 아티클 보기 →관련 모델
모든 모델 보기 →동일 유형
-
MiniMax H3 MiniMax $0.072 /초 -
Wan 3.0 Video Alibaba $0.040 /초 -
Wan 2.7 Video Alibaba $0.100 /초 -
Grok Imagine 1.5 xAI $0.011 /초 -
Veo 3.1 Fast Google $0.170 /초 -
Kling 4.0 Kuaishou $0.204 /초 -
Ray 3.2 Luma $0.214 /동영상 -
Kling 2.5 Kuaishou $0.090 /초 -
Seedance 2.0 ByteDance $0.017 /초 -
Kling 3.0 Kuaishou $0.100 /초 -
PixVerse V6 PixVerse $0.036 /초 -
Kandinsky 6.0 Pro $1.93 /동영상