MiniMax
MiniMax H3 Max Turbo
minimax-h3-max-turbo/image-to-video
MiniMax의 속도 최적화 모델 비디오 모델로, 텍스트→비디오와 이미지→비디오(첫 프레임 및 선택적 마지막 프레임 지정 가능)를 지원하며, 1회 생성으로 1~15초, 480P~1080P 클립을 만들어 마케팅 숏폼 영상의 빠른 초안 작성과 스토리보드 사전 시연에 적합합니다
minimax-h3-max-turbo/image-to-video 사용해 보기
입력
작품 갤러리
모든 작품 보기출력
video가격
minimax-h3-max-turbo/image-to-video per second
| 사양 | 단가 |
|---|---|
| 480P | $0.025 |
| 768P | $0.040 |
| 1080P | $0.080 |
포지셔닝 소개
단일 이미지를 첫 프레임으로 삼아 비디오 클립을 생성하며, 출력 캔버스는 입력 이미지의 비율을 따릅니다. 정적인 화면을 동적인 짧은 영상으로 전환해야 하는 개발자에게 적합하며, 소셜 미디어 콘텐츠 신속 제작, 광고 스토리보드의 동적 사전 시연, 이미지 소재의 동적展示 등에 활용할 수 있습니다. 선택적으로 마지막 프레임 이미지로 마무리 화면을 제약할 수 있으며, 프롬프트, 길이, 해상도 파라미터를 통해 생성 결과를 제어할 수 있습니다.
핵심 하이라이트
- 첫 프레임 기반 화면 생성——이미지 한 장을 첫 프레임으로 업로드하면 출력 비디오 캔버스가 해당 이미지 비율을 그대로 따르며, 구도의 시작점이 일치합니다.
- 선택적 마지막 프레임 제약——종료 프레임 이미지를 추가로 제공하면 비디오의 마지막 화면을 지정 이미지에 수렴시킬 수 있어, 전환이나 정지 마무리에 적합합니다.
- 길이와 해상도 조정 가능——1회 생성 길이는 1~15초 중 선택 가능하며, 해상도는 480P, 768P, 1080P 세 가지 중 하나를 고를 수 있습니다.
- 시드 제어 및 재현 가능——seed 파라미터로 난수 시드를 고정하면 배치 생성 시 동일한 화면 흐름을 재현하거나 미세 조정하기 쉽습니다.
기능 설명
첫 프레임 이미지 기반 비디오 생성: image_url로 첫 프레임 이미지를 지정하고 prompt와 결합해 동영상을 생성합니다. 출력 캔버스는 해당 이미지 비율을 따르므로 정적 이미지를 동적 클립으로 전환하기에 적합합니다.
마지막 프레임 화면 제약: 첫 프레임을 제공한 상태에서 end_image_url을 추가로 전달해 종료 프레임으로 삼을 수 있으며, 비디오의 마무리 화면이 지정 이미지에 가까워지도록 합니다. 전환이나 정지된 화면 연출에 사용됩니다.
길이 및 해상도 제어: duration은 1~15초 사이로 설정할 수 있고, 실제 출력은 요청보다 약 0.7초 길 수 있습니다. resolution은 480P, 768P, 1080P 세 가지 중 하나를 선택하며, 1080P는 768P 기본 생성 결과를 업스케일 정밀 보정한 것입니다.
프롬프트 확장 조절: prompt_expansion_mode는 disabled, balanced, quality 중 선택할 수 있으며, 각각 확장을 건너뛰거나 빠르게 반환하거나 약 30초를 들여 더 풍부한 프롬프트를 생성해 생성 세부 사항을 제어하는 데 도움을 줍니다.
활용 시나리오
- 소셜 미디어 이미지 동적화——운영 담당자가 제품 이미지나 포스터를 첫 프레임으로 삼고 짧은 프롬프트를 결합해 동적 짧은 영상을 빠르게 생성하여 소셜 플랫폼 게시나 피드 소재로 활용합니다.
- 광고 스토리보드 동적 사전 시연——광고나 영상 사전 제작 팀이 키프레임 이미지와 마지막 프레임 이미지로 전환 클립을 생성하여 동적 스토리보드 사전 시연으로 내부 제안이나 촬영 참고에 사용합니다.
- 이미지 소재를 비디오 클립으로 전환——콘텐츠 크리에이터가 사진 작품이나 일러스트를 첫 프레임으로 삼아 수 초 길이의 동적 클립을 생성하여 포트폴리오 전시나 영상 편집의 전환 장면에 활용합니다.
- 정지 마무리 장면 제작——첫 프레임과 마지막 프레임 두 장의 이미지로 화면의 시작과 끝을 제약해, 시작 화면에서 지정된 종료 화면으로 전환되는 클립을 생성하여 오프닝이나 엔딩의 정지 효과에 사용합니다.
제한 사항 및 선택 가이드
첫 프레임 이미지 image_url은 필수 입력 항목이며, 순수 텍스트 입력으로 생성하는 것은 지원하지 않습니다. 마지막 프레임 이미지는 선택적 제약으로, 화면이 해당 이미지에 정확히 수렴한다고 보장하지 않습니다. resolution을 1080P로 선택하면 768P 기본 생성 결과를 업스케일 정밀 보정한 출력이며, 기본 1080P 생성은 아닙니다. duration은 1~15초로 설정하며, 실제 출력은 요청보다 약 0.7초 길 수 있습니다. 프롬프트는 최대 50000자, 이미지 링크는 최대 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/image-to-video
routestring선택현재 고정 값: default
inputobject필수
minimax-h3-max-turbo/image-to-video 및 루트 default의 비즈니스 파라미터 객체. 아래 파라미터 표를 참조하세요.
seedinteger선택생성 결과의 무작위성을 제어하기 위한 랜덤 시드이며, 생략하면 무작위 시드가 자동으로 선택됩니다.
promptstring필수minLength 1maxLength 50000비디오 생성에 사용되는 텍스트 프롬프트입니다.
durationnumber선택기본값: 5min 1max 15비디오 길이(초)이며 기본값은 5초이고, 실제 출력은 요청 값보다 최대 약 0.7초 길 수 있습니다. target_audio_url을 제공하는 경우 길이는 최소 2초 이상이어야 합니다.
image_urlstring필수maxLength 50000첫 프레임으로 사용할 이미지 URL이며, 출력 캔버스는 해당 이미지를 따릅니다.
resolutionstring선택기본값: "768P"생성 해상도이며 기본값은 768P이고, 1080P를 지정할 수도 있으며 이 경우 네이티브 768P 소스에서 잠재 공간 정밀 보정을 수행합니다.
480P768P1080Pend_image_urlstring선택선택 사항이며, 마지막 프레임으로 사용할 이미지 URL입니다.
target_audio_urlstring선택선택 사항이며, 생성된 배경 음악에 고정할 오디오 클립 URL입니다. 해당 오디오는 최소 2초 길이여야 하고 최대 15 MB 크기여야 합니다.
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/image-to-video",
"input": {
"prompt": "…",
"duration": 5,
"image_url": "…",
"resolution": "768P",
"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/image-to-video",
input: {
"prompt": "…",
"duration": 5,
"image_url": "…",
"resolution": "768P",
"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/image-to-video",
"input": {
"prompt": "…",
"duration": 5,
"image_url": "…",
"resolution": "768P",
"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"
}
}
} 아티클
모든 아티클 보기 →관련 모델
모든 모델 보기 →동일 유형
-
Seedance 2.5 ByteDance $0.121 /초 -
P-Video 2 Pro Avatar Pruna AI $0.029 /초 -
Kling 4.0 Kuaishou $0.204 /초 -
Kling 2.5 Kuaishou $0.090 /초 -
Kling 4.0 Flash Kuaishou $0.122 /초 -
Veo 3.1 Google $0.290 /초 -
Runway Gen 4.5 Runway $0.172 /초 -
Kling 3.0 Turbo Kuaishou $0.144 /초 -
Hailuo 2.3 MiniMax $0.270 /동영상 -
FLUX 3 Max Black Forest Labs $0.121 /초 -
PixVerse V6 PixVerse $0.036 /초 -
FLUX 3 Video Black Forest Labs $0.090 /초



