Replicate를 통해 제공되는 MiniMax H3 멀티모달 비디오 생성 모델입니다. 텍스트-비디오, 첫/마지막 프레임 이미지-비디오, 레퍼런스 기반 생성(이미지·비디오·오디오를 프롬프트에서 인용)을 하나의 엔드포인트로 처리하며, 768P 또는 2K로 4~15초 영상을 생성합니다.
콘솔의 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",
"input": {
"prompt": "the car revs through the desert",
"first_frame_image": "https://example.com/car.png",
"duration": 5,
"resolution": "2K",
"ratio": "16:9"
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | Yes | - | 생성을 위한 텍스트 프롬프트 |
first_frame_image | string | No | - | 첫 프레임 이미지. 출력 영상이 이 이미지의 화면 비율을 따릅니다 |
last_frame_image | string | No | - | 마지막 프레임 이미지. 출력 영상의 마지막 프레임이 이 이미지와 일치합니다 |
reference_image_urls | array | No | - | 레퍼런스 이미지 공개 URL, 최대 9장 |
reference_video_urls | array | No | - | 레퍼런스 비디오 공개 URL, 최대 3개 |
reference_audio_urls | array | No | - | 레퍼런스 오디오 클립 공개 URL, 최대 3개 |
duration | integer | No | 5 | 출력 길이 초 (4~15). 초당 과금 456789101112131415 |
resolution | string | No | 2K | 출력 해상도. 768P는 초당 186크레딧, 2K는 초당 302크레딧 과금 768P2K |
ratio | string | No | 16:9 | 출력 화면 비율. 텍스트-비디오에서는 명시 필요, 이미지-비디오는 adaptive adaptive21:916:94:31:13:49:16 |
이 모델의 first_frame_imagelast_frame_imagereference_image_urlsreference_video_urlsreference_audio_urls 파라미터에 파일을 전달하는 방법은 3가지입니다.
공개 접근 가능한 URL을 직접 전달합니다. Storage API(POST /v1/files/upload-url)로 업로드하면 파일이 S3로 직접 올라가고(파일당 50MB), 반환된 file_url을 그대로 쓰면 됩니다.
{
"model": "minimax/h3",
"input": {
"prompt": "your prompt here",
"first_frame_image": "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" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:first_frame_image=@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로도 제공 |
정지 이미지를 프롬프트로 유도한 모션으로 애니메이션화
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",
"input": {
"prompt": "the car revs through the desert",
"first_frame_image": "https://example.com/car.png",
"duration": 5,
"resolution": "2K",
"ratio": "16:9"
}
}'레퍼런스 이미지로 피사체를 일관되게 유지
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",
"input": {
"prompt": "The woman from the reference images walks through a sunlit market, cinematic tracking shot",
"reference_image_urls": [
"https://example.com/subject-1.jpg"
],
"duration": 8,
"resolution": "768P",
"ratio": "adaptive"
}
}'