MiniMax H3 Image API
MiniMax H3 Image 텍스트 기반 이미지 생성 및 이미지 편집 모델의 전체 API 참조 문서입니다.
모델 종류
이 API는 두 가지 모델을 지원합니다:
빠른 비교
지원하는 화면 비율
1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9
픽셀 크기가 아닌 비율을 각각 숫자형 width와 height 값으로 지정하세요. 두 값을 모두 생략하면 비율은 기본값인 1:1이 됩니다. 그렇지 않으면 지원하는 정수 쌍 중 하나를 사용하여 두 값을 모두 지정하세요.
MiniMax H3 Image(텍스트 기반 이미지 생성)
엔드포인트 {#}
POST /api/v1/image/task
인증
Authorization: Bearer YOUR_API_KEY
요청 매개변수
필수
선택
참고: width:height 비율은 위에 나열된 15가지 지원 비율 중 하나여야 합니다.
요청 예시
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model_name: 'minimax-h3-image',
prompt: 'A serene mountain landscape at sunset',
width: 16,
height: 9,
resolution: '2k',
output_format: 'png'
})
});
const { data } = await response.json();
const taskId = data.task_id;
MiniMax H3 Image Edit(이미지 편집)
엔드포인트
POST /api/v1/image/task
요청 매개변수
필수
선택
참고: width:height 비율은 위에 나열된 15가지 지원 비율 중 하나여야 합니다.
요청 예시
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model_name: 'minimax-h3-image-edit',
prompt: 'Change the sky to sunset colors',
image_url_list: ['https://example.com/image.jpg'],
width: 16,
height: 9,
resolution: '2k',
output_format: 'png'
})
});
const { data } = await response.json();
const taskId = data.task_id;
단일 이미지 편집 예시
{
model_name: 'minimax-h3-image-edit',
prompt: 'Change the sky to sunset colors',
image_url_list: ['https://example.com/image.jpg'],
width: 16,
height: 9,
resolution: '2k',
output_format: 'png'
}
여러 이미지 합성 예시
{
model_name: 'minimax-h3-image-edit',
prompt: 'Combine these images into a cohesive landscape',
image_url_list: ['https://example.com/image1.jpg', 'https://example.com/image2.jpg'],
width: 16,
height: 9,
resolution: '2k',
output_format: 'png'
}
응답 형식
초기 응답
{
"code": 0,
"message": "success",
"data": {
"task_id": "{task_id}",
"response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
"task_status": "submitted"
}
}
폴링 응답
GET /api/v1/image/{task_id}를 폴링하여 상태를 확인하세요. 성공한 폴링 응답은 data.task_result.images[].url에 생성된 이미지 URL을 제공합니다.
상태 값
submitted: 작업 접수 완료
processing: 이미지 생성 중
succeed: 이미지 생성 완료
failed: 이미지 생성 실패
모범 사례
- 상세한 프롬프트: 피사체, 조명, 구도를 설명하고 프롬프트를 5000자 이내로 작성하세요
- 해상도 선택: 모든 요청에
1k, 2k 또는 4k를 명시적으로 전달하세요
- 화면 비율:
width와 height에 쌍을 이루는 비율 값을 지정하거나 두 값을 모두 생략하여 1:1을 사용하세요
- 이미지 편집 품질: 지원하는 형식 및 크기 요건을 충족하는 참조 이미지를 1-16장 제공하세요