MiniMax H3 Image API: 생성, 편집 및 실제 가격

동일 모델 제공업체 가격 비교: Cheap MiniMax H3 Image API · 2026-11-13

MiniMax H3 Image 기능과 호스티드 API 제한

H3 Image를 평가해야 하는 가장 큰 이유는 통합된 생성-편집 워크플로우입니다. 새로운 에셋을 설명하고, 제품이나 캐릭터 참조를 제공한 뒤, 특정 변경을 요청할 수 있습니다. MiniMax는 로컬 배포용 가중치도 공개합니다. 공개된 기능 주장이 모든 출력에서 정확한 로고, 타이포그래피 또는 정체성 보존을 보장하지는 않습니다.

호스티드 API 기능	문서화된 규격
생성	POST /v1/images/generations
편집	POST /v1/images/edits, 참조 이미지 1–16개
프롬프트	최대 32,000자, 향상 기능 없이는 처음 약 4,096 토큰만 적용
출력 크기	655,360–20,000,000 픽셀, 종횡비 1:3에서 3:1
출력 개수	n은 1에서 10
형식	기본 JPEG, PNG 또는 WebP 지원
응답	URL 또는 비스트리밍 Base64, 네이티브 SSE 지원
미지원 제어	마스크 편집, 투명 배경, 미리보기 이미지

참조 파일은 MiniMax의 입력 제한을 충족해야 합니다. JPG/JPEG, PNG, WebP, HEIC 또는 HEIF, 각 변 128–8,192 픽셀, 장변 대 단변 비율 최대 4:1, 총 요청 본문 최대 64 MiB입니다. Base64는 요청 크기를 증가시킵니다. 접근 가능한 이미지 URL이나 적절한 크기의 업로드를 사용하세요. 모델이 16개 이미지를 받아들일 수 있다 해도 본문 크기 제한이 사라지지는 않습니다.

이 API에서 "4K"는 면적 설정입니다. area: "4K"는 약 4096 × 4096 픽셀을 목표로 하며, 크기는 종횡비에서 파생됩니다. 16:9에서 문서화된 출력은 5472 × 3072이며, 4096 × 2304가 아닙니다. 명시적 크기를 원하면 size: "WIDTHxHEIGHT"를 보내고 area와 aspect_ratio를 생략하세요. 면적 기반 크기 지정에는 size: "auto", area, aspect_ratio를 사용하세요. data[].size와 다운로드한 이미지의 실제 크기를 확인하세요.

MiniMax H3 Image 비용은 얼마인가요?

현재 APIMaster Standard 라우트의 정상가 계산은 다음과 같습니다:

USD = (text_input_tokens × 2.30
     + image_input_tokens × 1.50
     + image_output_tokens × 3.80) / 1,000,000

텍스트와 이미지 사용량 필드를 별도로 사용하세요. 모든 입력 토큰을 텍스트로 청구한 뒤 이미지 입력을 다시 더하지 마세요. 프롬프트 향상은 청구되는 텍스트 토큰에 기여하므로, 해상도만으로 총 가격이 결정되지는 않습니다. 해당되는 경우 계정별 계수와 과금 반올림이 최종 청구액에 영향을 미칠 수 있습니다.

MiniMax의 공식 예시 Standard 합계는 청구 규모를 보여줍니다. 이는 예시이며, APIMaster 고정 요율이나 당사가 측정한 평균이 아닙니다:

작업	1K: 1024 × 1024	2K: 2048 × 2048	4K: 4096 × 4096, 정상 요율
텍스트-투-이미지	$0.02179	$0.02333	$0.06879
1K 참조 1개로 편집	$0.02654	$0.02658	$0.07312
1K 참조 3개로 편집	$0.03563	$0.04177	$0.07914

참고로, 첫 번째 예시 기준 텍스트-투-이미지 요청 1,000건은 약 $21.79입니다. 이는 예시적 토큰 예산 계산이며 선불 패키지가 아닙니다. 실제 프롬프트와 향상 기능이 이를 바꿀 수 있습니다. Nano Banana 2.1은 해상도 기반의 다른 APIMaster 계약을 가지며, 별도로 견적된 조건 전에 1K 이미지 1,000건당 $15.12부터 시작합니다.

공식 4K 50% 프로모션이 APIMaster에 적용되나요?

적용된다고 가정하지 마세요. MiniMax는 2026년 11월 17일 16:00 UTC(배타적)—베이징 시간 11월 18일 00:00—까지 최종 전달 이미지가 최소 16,600,000 픽셀일 때 Standard와 Highspeed의 총 요청 비용 50% 할인을 광고합니다. 이 기간 동안 정사각형 4K 텍스트-투-이미지 예시는 $0.06879에서 $0.03439로 바뀝니다.

4096 × 4096 출력은 면적 기준으로 충족하며, 4096 × 2304는 그렇지 않습니다. "4K"라는 라벨만으로는 충분하지 않습니다. 현재 APIMaster 공개 라우트는 이 임시 프로모션 없이 정상 토큰 요율을 사용합니다. MiniMax의 캠페인 헤드라인이 아니라 실제 결제/사용 계약을 비교하세요. 마감 이후에는 프로모션 예시를 현재 가격으로 사용해서는 안 됩니다.

MiniMax H3 Image API 예제: 텍스트-투-이미지

APIMaster 계정을 만들고, 유료 이미지 요청을 위한 잔액을 충전한 뒤, API keys에서 키를 생성하세요. 환경에 APIMASTER_API_KEY를 설정하세요. 이 예제는 Standard 라우트의 정확한 대소문자 구분 모델 ID를 사용합니다:

import os
import requests

base_url = "https://apimaster.ai/v1"
headers = {"Authorization": f"Bearer {os.environ['APIMASTER_API_KEY']}"}
response = requests.post(
    f"{base_url}/images/generations",
    headers=headers,
    json={
        "model": "MiniMax-H3-Image",
        "prompt": "A studio product photo of a matte blue teapot and two pears on a cream table, soft daylight, no text.",
        "size": "auto",
        "aspect_ratio": "16:9",
        "area": "2K",
        "n": 1,
        "response_format": "url",
    },
    timeout=600,
)
response.raise_for_status()
result = response.json()
for item in result.get("data", []):
    if item.get("error"):
        print("Image failed:", item["error"])
    else:
        print(item.get("url"), item.get("size"))
print("Usage:", result.get("usage"))

이것은 요청 예제이며 이미지 품질 벤치마크가 아닙니다. 성공한 출력 URL은 즉시 다운로드하여 파일을 직접 보관하세요. 이미지별 오류를 확인하세요. n > 1일 때 HTTP 200에 실패한 이미지가 포함될 수 있습니다. 타임아웃이 요청 거부를 증명하지는 않습니다. H3 생성은 멱등하지 않으므로, 자동 재시도가 또 다른 유료 생성을 만들 수 있습니다. OpenAI SDK를 사용한다면 충분히 긴 타임아웃과 max_retries=0을 설정하세요.

MiniMax H3 Image 편집: 참조 이미지와 프롬프트 제어

JSON 편집의 경우 참조 URL을 **images[].image_url**에 담아 보내세요. Nano Banana의 image_urls 필드를 이 H3 요청에 복사하지 마세요. 예제 URL을 접근 가능한 자신의 에셋으로 교체하세요:

edit = requests.post(
    f"{base_url}/images/edits",
    headers=headers,
    json={
        "model": "MiniMax-H3-Image",
        "prompt": "Keep the product shape and label from image 1. Use the background palette from image 2. Do not add text or change the product.",
        "images": [
            {"image_url": "https://example.com/product.png"},
            {"image_url": "https://example.com/palette.png"},
        ],
        "size": "2048x2048",
        "n": 1,
        "response_format": "url",
    },
    timeout=600,
)
edit.raise_for_status()
print(edit.json())

APIMaster의 기존 11월 11일 통합 수락 점검은 HTTP 참조, 데이터 URI, 멀티파트 업로드, 다중 참조 편집, SSE, 1K/2K/4K 디코딩 출력을 다뤘습니다. 통제된 두 참조 테스트에서 네 개의 색상 도형과 두 개의 짧은 라벨이 유지되었습니다. 이는 단순 에셋을 사용한 인터페이스 및 과금 점검이었으며, 폭넓은 사진 또는 타이포그래피 평가가 아닙니다. 다른 모델에 대한 우월성을 입증하지 않습니다.

생성은 기본적으로 프롬프트 향상을 사용합니다. 고정 크기나 고정 종횡비를 제공하면서 disable_prompt_enhanced: true로 비활성화할 수 있습니다. 편집은 항상 향상을 사용합니다. 예상치 못한 변경을 진단할 때 revised_prompt를 확인하세요. 제품 작업에서는 반드시 고정되어야 할 것을 명시하고, 각 참조의 역할을 식별하며, 게시 전에 렌더링된 라벨을 검증하세요.

Standard vs Highspeed, 그리고 오픈 가중치 vs 호스티드 API

Highspeed는 문서화된 동일한 API 매개변수를 사용하지만, 공식 이미지 입력 및 이미지 출력 요율은 Standard의 두 배입니다. 텍스트 입력은 $2.30/M으로 동일합니다. APIMaster는 현재 Standard만 제공합니다. MiniMax의 출시 속도 주장은 모델 변형, 크기, 배포에 따라 달라지며, APIMaster의 측정된 지연 보장이 아닙니다.

공식 Hugging Face 저장소는 Diffusers, SGLang, vLLM-Omni, ComfyUI를 포함한 가중치와 통합을 제공합니다. BF16 체크포인트는 약 68.65 GB이며, 별도의 약 66.7 GB 텍스트 인코더가 있습니다. 다운로드 크기는 완전한 GPU 메모리 추정치가 아닙니다. 로컬 가중치는 MiniMax H3 Image 커뮤니티 라이선스를 사용하므로, 배포 전에 해당 라이선스를 검토하세요. "오픈 가중치"가 MIT나 Apache 하의 무제한 사용을 의미하지는 않습니다.

호스티드 접근은 추론 인프라를 구축하지 않고 프롬프트를 평가하는 데 사용하세요. 추론에 대한 통제가 GPU, 유지보수, 라이선스 작업을 정당화할 때 로컬 배포를 고려하세요. 로컬 파이프라인 제한과 호스티드 API 제한은 서로 다른 계약입니다.

FAQ

MiniMax H3 Image는 MiniMax H3 비디오와 같은 건가요?

아니요. H3 Image는 MiniMax-H3-Image를 사용하여 정지 이미지를 생성하고 편집합니다. H3 비디오 제품군은 모델 ID, 엔드포인트, 과금이 다릅니다. 별도의 MiniMax H3 비디오 가이드를 참고하세요.

MiniMax H3 Image는 APIMaster에서 사용할 수 있나요?

네. 11월 13일 점검에서 활성화된 공개 Standard 라우트 하나를 확인했으며, 텍스트 입력 $2.30/M, 이미지 입력 $1.50/M, 이미지 출력 $3.80/M으로 과금됩니다. Highspeed는 공개 라우트가 없었습니다. 요청을 보내기 전에 실시간 모델 카드를 확인하세요.

H3 Image는 이미지당 고정 $0.02 API인가요?

아니요. 공식 이미지당 예시는 예시적 합계입니다. 실제 토큰 사용량, 프롬프트 향상, 참조 입력, 출력 크기가 청구서를 결정합니다. 현재 APIMaster 라우트는 정상 토큰 공식을 사용합니다.

H3 Image는 16개 참조나 마스크로 편집할 수 있나요?

형식과 요청 크기 제한 내에서 최대 16개의 참조 이미지를 문서화합니다. 마스크 편집과 투명 배경은 지원되지 않습니다. 참조 기반 지시가 픽셀 단위의 정확한 보존을 보장하지는 않습니다.

H3 Image와 Nano Banana 2.1 중 어느 것이 더 저렴한가요?

예시된 1K 텍스트-투-이미지 작업의 경우, H3의 정상 공식 예시는 $0.02179이며, APIMaster Nano Banana 2.1은 1K 이미지당 $0.01512부터입니다. 이는 예시 토큰 합계와 해상도 견적을 비교한 것입니다. 프롬프트에 대해 실제 수락된 출력 비용을 측정하세요. 전용 비교를 참고하세요.

출처 및 다음 단계

2026년 11월 13일 확인한 출처: MiniMax 릴리스, 호스티드 API 가이드, 공식 가격 및 프로모션, 모델 가중치 및 라이선스, Google 이미지 가격, APIMaster 실시간 마켓 카드. 기능 설명은 각 벤더에서 비롯되며, 가격 점검과 날짜가 기록된 APIMaster 통합 관찰은 별도로 명시됩니다.

H3 Image 카드를 열고, 등록한 뒤, API 키를 생성하고, MiniMax-H3-Image를 https://apimaster.ai/v1로 보내세요. 다른 과금 계약을 가진 할인 대안을 원하시면 Nano Banana 2.1 라우트를 비교하세요. 현재 Google 이미지 출력 기준가보다 최대 55% 저렴합니다.