MiniMax H3
ID:
hailuo/minimax-h3MiniMax H3(Hailuo 03)는 텍스트, 이미지, 영상, 오디오 참조를 하나로 묶어 네이티브 스테레오 사운드가 포함된 2K 영상을 만들어내는 통합 멀티모달 영상 생성 모델입니다. 새로운 씬을 구성하고, 정지 이미지에 생동감을 더하고, 기존 영상을 편집하는 모든 작업을 단일 MiniMax H3 API로 처리하세요.
MiniMax H3Hailuo 03텍스트 투 비디오2K 영상네이티브 오디오영상 편집
개요
MiniMax H3(Hailuo 03)는 텍스트, 이미지, 영상, 오디오 참조를 하나로 묶어 네이티브 스테레오 사운드가 포함된 2K 영상을 만들어내는 통합 멀티모달 영상 생성 모델입니다. 새로운 씬을 구성하고, 정지 이미지에 생동감을 더하고, 기존 영상을 편집하는 모든 작업을 단일 MiniMax H3 API로 처리하세요.
인증
모든 API 요청은 Authorization 헤더에 Bearer 방식으로 유효한 API 키를 전달해야 합니다.
빠른 시작
인증 정보
RUNBASE_API_KEY 환경 변수를 설정하세요.
Shell
export RUNBASE_API_KEY=your-api-key실행 생성
Shell
curl -s https://runbase.net/api/v1/runs \
-H "Authorization: Bearer $RUNBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "hailuo/minimax-h3",
"input": {
"prompt": "A cinematic product photo of a ceramic lamp"
}
}'실행
실행은 비동기로 처리됩니다. 요청을 제출한 후 결과를 폴링하세요.
실행 생성
Shell
curl -s https://runbase.net/api/v1/runs \
-H "Authorization: Bearer $RUNBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "hailuo/minimax-h3",
"input": { "prompt": "A cinematic product photo of a ceramic lamp" }
}'실행 상태 조회
Shell
curl -s https://runbase.net/api/v1/runs/RUN_ID \
-H "Authorization: Bearer $RUNBASE_API_KEY"결과 조회
status가 "succeeded"가 될 때까지 상태 엔드포인트를 폴링한 후 응답에서 output.urls를 읽으세요.
입력 스키마
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
| prompt | string | 필수 | Prompt최대 7000자 |
| aspect_ratio | string | 선택 | Aspect ratio옵션: 16:99:161:14:33:421:9기본값: 16:9 |
| resolution | string | 선택 | 2K requires at least one reference image; text-only generation supports 768p only.옵션: 768p2k기본값: 768p |
| duration | number | 선택 | Duration (seconds)범위: 4–15기본값: 5 |
| image_urls | string[] | 선택 | Reference images최대 5장의 이미지 |
출력 스키마
| 필드 | 유형 | 설명 |
|---|---|---|
| urls | string[] | 생성된 출력 URL |
오류
API는 표준 HTTP 상태 코드를 사용하여 성공 또는 실패를 나타냅니다.
| 상태 코드 | 설명 |
|---|---|
| 400 | Ungültige Anfrage – fehlende oder fehlerhafte Parameter |
| 401 | Authentifizierung fehlgeschlagen – fehlender oder ungültiger API-Schlüssel |
| 402 | Unzureichendes Guthaben |
| 403 | Zugriff verweigert – IP nicht erlaubt, Konto gesperrt oder Ausgabenlimit des API-Schlüssels überschritten |
| 404 | Ausführung nicht gefunden |
| 429 | Rate-Limit überschritten |
| 500 | Interner Serverfehler |

