Fal.AI를 통해 제공되는 MiniMax H3 Max 이미지-비디오 모델입니다. MiniMax Hailuo-03(H3)을 fal이 추가 학습한 변형으로 프롬프트 충실도와 미감이 강화되었으며, 첫 프레임 이미지(키프레임 제어용 마지막 프레임은 선택)를 네이티브 오디오가 포함된 5-15초 클립으로 480P/768P 네이티브 또는 1080P 정제 출력으로 만듭니다.
콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요
이 모델의 사용법을 Claude, ChatGPT 등에 복사
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "minimax/h3-max/image-to-video",
"input": {
"prompt": "The camera slowly pulls back from the scene, revealing the full landscape as clouds drift overhead and light shifts across the terrain.",
"image_url": "https://storage.googleapis.com/falserverless/example_inputs/hailuo23/pro_i2v_in.jpg",
"duration": 5,
"resolution": "768P"
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | Yes | - | 비디오 생성을 위한 텍스트 프롬프트입니다(최대 50,000자). |
image_url | string | Yes | - | 첫 프레임으로 쓸 이미지 URL입니다. 출력 화면 비율은 이 이미지를 따릅니다. |
end_image_url | string | No | - | 첫 프레임→마지막 프레임 키프레임 생성을 위한 마지막 프레임 이미지 URL입니다(선택). |
duration | integer | No | 5 | 비디오 길이(초, 5-15)이며 초 단위로 과금됩니다. |
resolution | string | No | 768P | 480P·768P는 네이티브 생성 모드, 1080P는 768P 원본을 잠재 공간에서 정제한 결과입니다. 480P768P1080P |
prompt_expansion_mode | string | No | balanced | 생성 전 프롬프트 리라이팅에 들일 노력입니다. 'disabled'는 확장하지 않고, 'balanced'는 약 1초, 'quality'는 최대 30초까지 들여 풍부하게 확장합니다. disabledbalancedquality |
enable_safety_checker | boolean | No | true | true면 세이프티 체커가 활성화됩니다. |
seed | integer | No | - | 랜덤 시드입니다. 생략하면 무작위로 선택됩니다. |
이 모델의 image_urlend_image_url 파라미터에 파일을 전달하는 방법은 3가지입니다.
공개 접근 가능한 URL을 직접 전달합니다. Storage API(POST /v1/files/upload-url)로 업로드하면 파일이 S3로 직접 올라가고(파일당 50MB), 반환된 file_url을 그대로 쓰면 됩니다.
{
"model": "minimax/h3-max/image-to-video",
"input": {
"prompt": "your prompt here",
"image_url": "https://example.com/image.jpg"
}
}POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 없는 대신, 파일이 API 서버를 거치므로 요청 전체 10MB 제한이 적용됩니다.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=minimax/h3-max/image-to-video" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:image_url=@your_file.png"POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | Yes | - | 모델 식별자 |
input | object | Yes | - | 위 테이블의 모델별 파라미터를 포함하는 객체 |
output_folder | string | No | - | 결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가) |
webhook_url | string | No | - | 완료 시 호출할 Webhook URL |
is_public | boolean | No | false | true 시 결과물을 영구 공개 URL로도 제공 |
기본 768P로 정지된 풍경 이미지에서 카메라가 뒤로 빠지는 장면입니다.
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "minimax/h3-max/image-to-video",
"input": {
"prompt": "The camera slowly pulls back from the scene, revealing the full landscape as clouds drift overhead and light shifts across the terrain.",
"image_url": "https://storage.googleapis.com/falserverless/example_inputs/hailuo23/pro_i2v_in.jpg",
"duration": 5,
"resolution": "768P"
}
}'최종 렌더 전에 움직임을 확인하는 저렴한 480P 8초 초안입니다.
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "minimax/h3-max/image-to-video",
"input": {
"prompt": "Clouds race across the sky as sunlight sweeps over the hills, time-lapse feel.",
"image_url": "https://storage.googleapis.com/falserverless/example_inputs/hailuo23/pro_i2v_in.jpg",
"duration": 8,
"resolution": "480P"
}
}'