MiniMax H3-Image: 이미지 생성 API로 확인한 내용과 가중치·편집의 미확인 사항
확보된 공식 문서에서 텍스트 이미지 생성 매개변수, 출력 제한, 재시도 과금을 확인했습니다. 출시일, 공개 가중치 라이선스, 참조 이미지 편집 방식은 이 자료만으로 확정할 수 없습니다.
·

minimax h3 image를 검색할 때는 모델 발표, 가중치 공개, 이미지 편집, API 도입 조건을 구분해야 합니다. 확보된 MiniMax 공식 문서는 H3-Image 텍스트 이미지 생성 API의 요청 방식과 제한을 설명하지만, 가중치 공개 조건이나 편집 기능, 로컬 실행 요건까지 입증하지는 않습니다.
이 글은 확보된 공식 Text-to-Image 문서를 검토한 내용이며 API 실측이 아닙니다. 자료 수집일은 2026년 11월 16일이고 페이지 수정일은 알 수 없습니다. 기획에 제시된 ‘11월 11일 발표’와 공개 가중치라는 설명은 발표문 및 모델 카드 본문과 대조하지 못했으므로 확정된 뉴스로 다루지 않습니다.
텍스트 이미지 생성 문서에 명시된 사양
엔드포인트는 POST https://api.minimax.io/v1/images/generations이며 Bearer API 키로 인증합니다. 모델은 MiniMax-H3-Image와 MiniMax-H3-Image-Highspeed를 지원하고, 매개변수와 제한은 동일합니다. Highspeed라는 이름만으로 구체적인 속도 향상이나 품질 차이를 판단할 수는 없습니다.
| 항목 | 문서에 명시된 내용 | 사용 시 의미 |
|---|---|---|
| 프롬프트 | 필수. 앞뒤 공백을 제외하고 최대 32,000 유니코드 문자 | 프롬프트 향상을 끄면 약 처음 4,096토큰만 읽음. 문자 수 상한과 유효 입력 길이는 다름 |
| 이미지 수 | n은 1–10, 기본값 1 | 이미지 수, 크기, 반환 형식의 모든 조합이 허용되는 것은 아님 |
| 너비·높이 직접 지정 | 면적 655,360–20,000,000픽셀, 종횡비 1:3–3:1. 경계값 포함 | WIDTHxHEIGHT 사용 시 aspect_ratio와 area를 함께 보내면 안 됨. auto도 불가 |
| 면적 등급 | area는 1K, 2K, 4K, 기본값 4K | 긴 변의 고정 길이가 아니라 목표 면적을 뜻함 |
| 출력 및 반환 | PNG, JPEG, WebP. URL 또는 Base64 반환 | 스트리밍은 URL만 지원하며 URL의 장기 유효성은 보장하지 않음 |
이 제한은 공식 매개변수 설명에 근거합니다. 문서에서 2K와 16:9 조합의 출력 예시는 2720×1536입니다. 실제 크기는 등급명으로 추정하지 말고 각 이미지의 data[].size에서 확인해야 합니다.
Base64 반환에는 요청 전체의 출력 면적 제한도 있습니다. PNG는 20,000,000픽셀, JPEG/WebP는 80,000,000픽셀입니다. n이 10 이하여도 반환 형식의 면적 제한을 넘으면 유효한 요청이 아닙니다.
시간 초과와 일부 실패가 도입 판단에 미치는 영향
공식 문서는 서버 대기 시간이 최대 600초이며 클라이언트 제한 시간을 최소 600초로 설정하라고 안내합니다. 이 엔드포인트는 멱등성을 보장하지 않습니다. 클라이언트 연결이 끊기거나 시간 초과가 발생해도 서버는 생성을 완료하고 성공한 이미지에 과금합니다. 재시도하면 다시 생성하고 다시 과금합니다. OpenAI SDK에서는 기본 자동 재시도를 끄도록 max_retries=0을 지정하라고 설명합니다.
따라서 응답을 받지 못했다는 사실이 서버가 요청을 실행하지 않았다는 뜻은 아닙니다. 시간 초과 직후 재전송을 추가 비용 없는 작업으로 간주해서는 안 됩니다.
HTTP 200 역시 모든 이미지의 성공을 뜻하지 않습니다. 적어도 한 장이 성공하면 200을 반환할 수 있고, 실패한 항목에는 error만 들어 있습니다. data[].error를 항목별로 확인해야 합니다. 문서는 성공한 이미지에만 과금한다고 설명하지만, 확보된 본문에는 실제 비용 계산에 필요한 단가가 없습니다. 사용량 필드를 요금표처럼 해석할 수는 없습니다.
참조 이미지·편집·가중치 공개에는 별도 근거가 필요
확보된 페이지는 텍스트 이미지 생성용입니다. 참조 이미지 업로드, 마스크 편집, 부분 수정의 사용 절차는 여기서 확인할 수 없습니다. 모델이 이런 기능을 지원하지 않는다는 뜻이 아니라, 현재 자료로는 지원 방식과 사용 조건을 확정할 수 없다는 뜻입니다.
API를 호출할 수 있다는 사실은 가중치를 내려받을 수 있다는 증거도 아닙니다. 가중치를 받을 수 있어도 무제한 상업적 이용이 자동으로 허용되는 것은 아닙니다. 로컬 실행에는 실행 코드, 하드웨어 요건, 정밀도 설정이 필요하며 API 출력 크기만으로 필요한 GPU 메모리를 계산할 수 없습니다.
완전한 출시 기사로 작성하려면 공식 발표문, 모델 카드, 라이선스 본문을 읽고 출시일, 가중치 제공 방식, 상업적 이용 조건, 실행 요건을 확인해야 합니다. 참조 이미지와 편집 주장에는 해당 엔드포인트 문서도 필요합니다. 현재 문서는 텍스트 이미지 생성 API 도입 검토에는 도움이 되지만, 로컬 배포나 상업적 이용 허가, 편집 기능의 제공 여부를 확정하는 근거로는 부족합니다.