Image link valid for 72 hours
MiniMax H3 Image Highspeed API 요금
숨겨진 수수료 없는 투명한 요금제. 사용한 만큼만 지불하세요.
| 모델 | 등급 | 골드 가격현재 가격 | 플래티넘 가격 | 다이아몬드 가격 | 공식 가격 | 절약률 |
|---|---|---|---|---|---|---|
minimax-h3-image-highspeed표시된 가격은 예상 가격이며, 실제 비용은 토큰 사용량 기준으로 청구됩니다. | 1K/2K | 0.3354Credits/장~$0.0335/장 | 0.3187Credits/장~$0.0319/장 | 0.3019Credits/장~$0.0302/장 | 0.4193Credits/장~$0.0419/장 | 20% |
| 4K | 1.2131Credits/장~$0.1213/장 | 1.1525Credits/장~$0.1152/장 | 1.0918Credits/장~$0.1092/장 | 1.5164Credits/장~$0.1516/장 | 20% |
* 실제 비용은 최종 출력에 따라 달라집니다.
* 토큰 기준으로 과금됩니다. 표의 값은 텍스트-이미지 1장 기준 예상치로, 이미지 출력과 프롬프트 확장에 쓰이는 약 2,000개의 텍스트 입력 토큰을 포함합니다. 참조 이미지를 쓰면 이미지 입력 토큰이 추가됩니다. 실제 청구액은 각 작업의 cost 필드에 표시됩니다.
MiniMax H3 Image Highspeed API: 더 빠른 텍스트-이미지 생성과 편집, 최대 4K
Highspeed 버전은 MiniMax H3 Image와 같은 파라미터로 더 빠르게 생성합니다. 텍스트-이미지 생성 또는 참조 이미지 최대 16장 편집을 지원하고, 1K, 2K, 4K나 정확한 픽셀 크기를 지정할 수 있으며, 요청당 최대 10장을 생성합니다.
MiniMax H3 Image Highspeed API 예제: 텍스트-이미지와 이미지 편집
APIMart에서 POST 요청 한 번으로 MiniMax H3 Image Highspeed를 호출합니다. 생성은 비동기로 진행됩니다. 작업을 제출한 다음 작업 엔드포인트를 폴링해 이미지 URL을 받습니다.
- 1
MiniMax H3 Image Highspeed API 요청 인증
APIMart 키를 환경 변수 APIMART_API_KEY에 저장하고 모든 요청에 Authorization: Bearer <key>로 보냅니다.
- 2
MiniMax H3 Image Highspeed 작업 제출
model minimax-h3-image-highspeed와 프롬프트, 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 Highspeed 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-highspeed",
"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-highspeed",
"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-highspeed",
"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 Highspeed API 파라미터
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | 필수 | 기본값: minimax-h3-image-highspeed | minimax-h3-image-highspeed를 사용합니다. |
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 생성임을 알리는 워터마크를 이미지에 눈에 보이게 넣습니다. |
