MiniMax H3 API
MiniMax H3 동영상 생성 모델의 전체 API 레퍼런스입니다.
모델 변형
이 API는 세 가지 모델 변형을 지원합니다.
빠른 비교
지원되는 화면 비율
텍스트 투 비디오와 레퍼런스 투 비디오는 다음을 지원합니다.
21:9, 16:9, 4:3, 1:1, 3:4, 9:16
해상도 옵션
MiniMax H3 텍스트 투 비디오
엔드포인트 {#}
POST /api/v1/video/task
요청 파라미터
필수
요청 예시
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model_name: 'minimax-h3-text-to-video',
prompt: '햇빛이 비치는 초원을 달리는 골든 리트리버',
duration: 8,
resolution: '2k',
aspect_ratio: '16:9'
})
});
const { data } = await response.json();
const taskId = data.task_id;
MiniMax H3 이미지 투 비디오
엔드포인트
POST /api/v1/video/task
요청 파라미터
필수
선택 사항
참고: 이미지 투 비디오는 aspect_ratio를 지원하지 않습니다.
요청 예시
{
model_name: 'minimax-h3-image-to-video',
image_url: 'https://example.com/first-frame.jpg',
image_end_url: 'https://example.com/last-frame.jpg',
prompt: '카메라가 천천히 뒤로 이동하며 전체 풍경을 보여 줍니다',
duration: 8,
resolution: '2k'
}
MiniMax H3 레퍼런스 투 비디오
선택적 이미지, 동영상 및 오디오 참조로 새로운 동영상을 생성합니다.
엔드포인트
POST /api/v1/video/task
요청 파라미터
필수
참조 미디어
@ (AT) 참조 플레이스홀더
@ (AT) 참조 기능은 번호가 지정된 <<<...>>> 플레이스홀더를 통해 참조 미디어를 프롬프트에 연결합니다. 번호는 미디어 유형별로 각각 1부터 시작하며 해당 배열의 순서를 따릅니다.
예를 들어 첫 번째 이미지가 캐릭터 참조이고 두 번째 이미지가 장면 참조라면, prompt에서 캐릭터에는 <<<image_1>>>을, 장면에는 <<<image_2>>>를 사용합니다. 각 플레이스홀더는 해당 배열에 존재하는 항목을 가리켜야 합니다.
요청 예시
{
model_name: 'minimax-h3-reference-to-video',
prompt: '이미지 1은 피사체에, 동영상 1은 움직임에, 오디오 1은 분위기에 사용합니다',
duration: 8,
resolution: '2k',
aspect_ratio: '16:9',
images: ['https://example.com/subject-reference.jpg'],
videos: ['https://example.com/motion-reference.mp4'],
audios: ['https://example.com/atmosphere-reference.mp3']
}
@ (AT) 레퍼런스 투 비디오 요청 예시
{
model_name: 'minimax-h3-reference-to-video',
prompt: '<<<image_1>>>의 탐험가를 <<<image_2>>>의 환경에 배치하고, <<<video_1>>>의 카메라 움직임을 따르며 <<<audio_1>>>의 참조 음성으로 말하게 합니다',
duration: 10,
resolution: '2k',
aspect_ratio: '16:9',
images: [
'https://example.com/explorer-reference.jpg',
'https://example.com/environment-reference.jpg'
],
videos: ['https://example.com/camera-movement-reference.mp4'],
audios: ['https://example.com/voice-reference.mp3']
}
응답 형식
초기 응답
모든 모델은 폴링에 사용할 task_id를 반환합니다.
{
"code": 0,
"message": "success",
"data": {
"task_id": "{task_id}",
"response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
"task_status": "submitted"
}
}
폴링 응답
GET /api/v1/video/{taskId}를 폴링하여 상태를 확인합니다.
{
"code": 0,
"message": "success",
"data": {
"task_id": "{task_id}",
"response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
"task_status": "succeed",
"task_status_msg": null,
"task_result": {
"videos": [
{
"url": "https://example.com/generated-video.mp4"
}
]
}
}
}
상태 값
submitted: 작업이 접수되어 처리 대기 중processing: 동영상 생성 진행 중succeed: 동영상 생성 완료failed: 동영상 생성 실패
모범 사례
- 움직임을 명확하게 설명: 프롬프트에 구체적인 움직임 설명을 포함합니다
- 해상도 선택: 더 빠른 처리에는
768p, 더 높은 품질의 출력에는 2k를 사용합니다
- 이미지 품질: 이미지 투 비디오에서는 최상의 결과를 위해 고품질 입력 이미지를 사용합니다
- 참조 순서:
images, videos, audios를 의도한 순서로 유지하고 프롬프트에서 일관되게 참조합니다
- @ (AT) 참조: 장면의 각 부분에 영향을 주는 참조 에셋을 명시적으로 제어해야 할 때
<<<image_N>>>, <<<video_N>>>, <<<audio_N>>> 플레이스홀더를 사용합니다