Image link valid for 72 hours
MiniMax H3 Image API 요금
숨겨진 수수료 없는 투명한 요금제. 사용한 만큼만 지불하세요.
| 모델 | 등급 | 골드 가격현재 가격 | 플래티넘 가격 | 다이아몬드 가격 | 공식 가격 | 절약률 |
|---|---|---|---|---|---|---|
minimax-h3-image표시된 가격은 예상 가격이며, 실제 비용은 토큰 사용량 기준으로 청구됩니다. | 1K/2K | 0.1891Credits/장~$0.0189/장 | 0.1797Credits/장~$0.018/장 | 0.1702Credits/장~$0.017/장 | 0.2364Credits/장~$0.0236/장 | 20% |
| 4K | 0.628Credits/장~$0.0628/장 | 0.5966Credits/장~$0.0597/장 | 0.5652Credits/장~$0.0565/장 | 0.785Credits/장~$0.0785/장 | 20% |
* 실제 비용은 최종 출력에 따라 달라집니다.
* 토큰 기준으로 과금됩니다. 표의 값은 텍스트-이미지 1장 기준 예상치로, 이미지 출력과 프롬프트 확장에 쓰이는 약 2,000개의 텍스트 입력 토큰을 포함합니다. 참조 이미지를 쓰면 이미지 입력 토큰이 추가됩니다. 실제 청구액은 각 작업의 cost 필드에 표시됩니다.
MiniMax H3 Image API: 최대 4K 텍스트-이미지 생성과 이미지 편집
프롬프트로 이미지를 생성하거나 참조 이미지를 최대 16장까지 넣어 편집합니다. 1K, 2K, 4K 중에서 고르고 가로세로 비율은 1:3부터 3:1까지 자유롭게 지정할 수 있으며, 최대 2,000만 픽셀까지 픽셀 크기를 직접 지정할 수도 있습니다. 요청 한 번에 최대 10장을 반환하고, 내장된 프롬프트 확장 기능이 짧은 프롬프트를 자동으로 풀어 씁니다.
MiniMax H3 Image API 예제: 텍스트-이미지와 이미지 편집
APIMart에서 POST 요청 한 번으로 MiniMax H3 Image를 호출합니다. 생성은 비동기로 진행됩니다. 작업을 제출한 다음 작업 엔드포인트를 폴링해 이미지 URL을 받습니다.
- 1
MiniMax H3 Image API 요청 인증
APIMart 키를 환경 변수 APIMART_API_KEY에 저장하고 모든 요청에 Authorization: Bearer <key>로 보냅니다.
- 2
MiniMax H3 Image 작업 제출
model minimax-h3-image와 프롬프트, size, resolution을 담아 POST /v1/images/generations를 호출합니다. 참조 이미지로 편집하려면 image_urls를 추가합니다. 작업 ID는 data[0].task_id에 있습니다.
- 3
생성된 이미지 받기
status가 completed가 될 때까지 3~5초마다 GET /v1/tasks/{task_id}를 폴링한 뒤 data.result.images[0].url에서 이미지 URL을 읽습니다. 결과는 72시간 동안 보관되므로 제때 내려받으세요.
모든 파라미터, 크기 규칙, 응답 필드는 MiniMax H3 Image API 문서에서 확인하세요.
curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-image",
"prompt": "해 질 녘 바닷가의 아늑한 카페, 실사 같은 묘사, 따뜻한 색감",
"size": "16:9",
"resolution": "2K"
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "minimax-h3-image",
"prompt": "해 질 녘 바닷가의 아늑한 카페, 실사 같은 묘사, 따뜻한 색감",
"size": "16:9",
"resolution": "2K"
}
resp = requests.post(f"{API_BASE}/v1/images/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["images"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(3)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-image",
"prompt": "두 번째 이미지의 재킷을 첫 번째 이미지의 인물에게 입히고, 배경은 그대로 유지해 주세요",
"image_urls": [
"https://example.com/person.jpg",
"https://example.com/jacket.png"
],
"resolution": "2K"
}'TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"MiniMax H3 Image API 파라미터
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | 필수 | 기본값: minimax-h3-image | minimax-h3-image를 사용합니다. |
prompt | string | 필수 | 기본값: — | 이미지 설명. 앞뒤 공백을 제외하고 1~32,000자입니다. |
size | string | 선택 | 기본값: auto | auto, 16:9 같은 가로세로 비율(1:3부터 3:1까지), 또는 2048x1152 같은 픽셀 크기(총 655,360~20,000,000픽셀). |
aspect_ratio | string | 선택 | 기본값: — | 가로세로 비율을 전달하는 또 다른 방법입니다(예: 16:9). 설정하면 size보다 우선합니다. |
resolution | string | 선택 | 기본값: 4K | 1K, 2K 또는 4K. size를 픽셀 크기로 지정한 경우에는 사용할 수 없습니다. |
n | integer | 선택 | 기본값: 1 | 이미지 수. 1부터 10까지. |
image_urls | string[] | 선택 | 기본값: — | 참조 이미지 최대 16장. URL 또는 Base64 data URI로 넣습니다. 추가하면 편집으로 전환됩니다. |
prompt_optimizer | boolean | 선택 | 기본값: true | 생성 전에 프롬프트를 풀어 씁니다. false는 크기를 명시한 텍스트-이미지 생성에서만 동작합니다. |
output_format | string | 선택 | 기본값: jpeg | jpeg, png 또는 webp. |
output_compression | integer | 선택 | 기본값: 95 | 압축 품질. 0부터 100까지. png에서는 무시됩니다. |
watermark | boolean | 선택 | 기본값: false | AI 생성임을 알리는 워터마크를 이미지에 눈에 보이게 넣습니다. |
