Fal.AI를 통해 제공되는 MiniMax Hailuo-03(H3) 이미지-투-비디오 모델입니다. 첫 프레임 이미지를 기반으로 2K 해상도의 5~15초 영상을 생성하며, 네이티브 오디오와 end_image_url을 이용한 첫-마지막 키프레임 제어를 지원합니다.
콘솔의 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/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": "2K"
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | Yes | - | 영상 생성을 위한 텍스트 프롬프트 |
duration | integer | No | 5 | 생성될 영상의 길이(초 단위)입니다. |
resolution | string | No | 2K | 생성될 영상의 해상도입니다. 768P2K |
image_url | string | Yes | - | 첫 프레임으로 사용할 이미지의 URL입니다. 출력 화면비는 이 이미지를 따라갑니다. |
end_image_url | string | No | - | 선택 항목으로, 첫-마지막 키프레임 생성을 위해 마지막 프레임으로 사용할 이미지 URL입니다. |
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로도 제공 |
정적인 풍경 이미지를 카메라가 뒤로 물러나며 전체 장면을 드러내는 5초짜리 2K 클립으로 애니메이션화합니다.
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/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": "2K"
}
}'시작 이미지와 종료 이미지를 함께 제공하여 두 이미지 사이를 잇는 더 긴 전환 영상을 생성합니다.
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/image-to-video",
"input": {
"prompt": "A smooth cinematic transition as the scene transforms from day to night.",
"image_url": "https://example.com/start-frame.jpg",
"end_image_url": "https://example.com/end-frame.jpg",
"duration": 10,
"resolution": "2K"
}
}'