MiniMax H3 Image 시작하기: 텍스트-투-이미지, 다중 이미지 참조 편집, 파라미터와 가격

MiniMax H3 Image는 MiniMax의 이미지 모델로, HiAPI에서는 두 개의 호출 ID를 제공합니다: minimax-h3-image/text-to-image(텍스트-투-이미지)와 minimax-h3-image/image-to-image(1–16장의 참조 이미지로 생성 또는 편집). 이 글에서는 두 ID를 어떻게 선택하는지, 파라미터는 어떻게 채우는지, 비용은 어떻게 계산하는지, 그리고 호출 시 주의할 세부 사항을 명확히 설명합니다.

두 ID 중 무엇을 선택할까

• 텍스트 설명만 있는 경우: text-to-image를 사용하며, 필수 항목은 prompt 하나뿐입니다(최대 5000자).
• 참조할 이미지가 있는 경우: image-to-image를 사용하며, image_urls가 추가로 필수입니다(1–16장). 상품 이미지의 배경을 바꾸거나, 사진을 일러스트나 유화 스타일로 재그리기할 수 있고, 여러 장의 참조 이미지를 동시에 줄 수도 있습니다.
• 두 ID의 이미지 생성 가격은 동일하며, 이미지-투-이미지는 참조 이미지 장수에 따라 추가 요금이 붙습니다. 아래 「가격」을 참고하세요.

파라미터

• resolution: 1K / 2K / 4K, 기본값은 2K입니다. 예를 들어 2K 1:1은 2048×2048, 1K 9:16은 768×1360, 4K 16:9는 5472×3072를 출력합니다.
• aspect_ratio: auto, 1:1, 5:4, 4:5, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9. 텍스트-투-이미지의 기본값은 1:1이고, 이미지-투-이미지의 기본값은 auto로 모델이 프롬프트와 참조 이미지를 바탕으로 비율을 스스로 선택하며 첫 번째 참조 이미지와 반드시 일치하지는 않습니다. 화면 비율을 고정하려면 비율을 명시하세요.
• output_format: jpeg(기본값) 또는 png. PNG는 용량이 훨씬 크며 4K PNG는 30MB에 달할 수 있으므로 특별한 필요가 없다면 jpeg를 사용하세요.
• seed: 선택 사항, 0–2147483647, 같은 이미지를 재현하고 싶을 때 고정하세요.
• 요청마다 이미지 1장을 생성하며, 사용자 지정 너비/높이, 투명 배경, 마스크 부분 재그리기는 지원하지 않습니다.

호출 예시

작업 제출:

curl https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-image/image-to-image",
    "input": {
      "prompt": "세럼 병을 옅은 석재 받침대 위에 배치하고, 부드러운 측광, 깔끔한 이커머스 제품 촬영",
      "image_urls": ["https://example.com/bottle.png"],
      "resolution": "2K",
      "aspect_ratio": "3:4"
    }
  }'

data.taskId가 반환되면 GET https://api.hiapi.ai/v1/tasks/<taskId>를 폴링합니다. status가 success로 바뀌면 이미지 주소는 data.output[0].url에 있습니다. 2K 이미지는 보통 30–40초에 결과가 나옵니다. 결과 링크에는 유효 기간이 있으며(필드 expireAt), 장기 보관이 필요하면 직접 다운로드하여 저장하세요.

가격

• 1K, 2K: 장당 $0.0129.
• 4K: 장당 $0.0393.
• 이미지-투-이미지는 참조 이미지 1장당 $0.0036이 추가됩니다. 예를 들어 2K에 참조 이미지 3장: 0.0129 + 3 × 0.0036 = $0.0237.
• 이미지 생성에 성공한 작업에만 과금되며, 작업이 실패하면 전액 환불됩니다.

프롬프트 작성법

• 「주체 + 장면 + 조명 + 스타일 + 구도」 순서로 명확하게 작성하세요.
• 이미지-투-이미지에서는 무엇을 유지하고 무엇을 바꿀지 명확히 설명하세요. 예: 「인물의 이목구비와 자세는 유지하고, 배경은 따뜻한 회색 덩어리로 바꾸며, 전체를 유화 붓터치로 변경」.
• 먼저 1K 또는 2K로 구도를 시험해 보고, 확정된 후에 4K로 출력하세요. 4K 단가는 2K의 약 3배입니다.