MiniMax H3 Image Highspeed API
MiniMax H3 Image Highspeed는 텍스트와 이미지를 입력받아 이미지를 생성·편집하는 속도 최적화 오픈 웨이트 모델입니다.
MiniMax H3 Image Highspeed는 MiniMax H3 Image 라인업에서 속도를 최적화한 변형 모델입니다. 텍스트 프롬프트로 이미지를 생성하거나 기존 이미지를 편집할 수 있으며, 한 번의 생성에 최대 16개의 참조 이미지를 조합할 수 있습니다. 긴 프롬프트를 읽고 길고 밀도 높은 텍스트를 이미지에 렌더링하는 기능을 갖춘 오픈 웨이트 모델입니다.
Highspeed 모드는 표준 모드보다 3~4배 빠르며, 표준 모드는 일부 경쟁 모델보다 1.5~2배 빠릅니다. 약 16메가픽셀의 원본 해상도로 이미지를 출력하고 1:3부터 3:1까지의 종횡비를 지원하며, 표준 버전과 동일한 파라미터와 제한을 사용합니다. 비교적 낮은 사양의 하드웨어에서도 로컬 실행이 가능합니다.
포스터, 인포그래픽, UI 화면, 마케팅 자료 제작과 신속한 프로토타이핑, 배치 처리에 적합합니다. 복잡한 구도와 다중 요소 장면 구성, 캐릭터 일관성이 필요한 작업에도 활용할 수 있습니다. 다만 32배 공간 압축으로 인해 특정 해상도에서 상당히 흐려질 수 있고 세밀한 디테일이 부족할 수 있으며, 32b 텍스트 인코더로 인해 모델이 무겁습니다.
업데이트:
모델 ID
minimax-h3-image-highspeed- 입력
- text / image
- 출력
- image
주요 특징
- 표준 모드보다 3~4배 빠른 Highspeed 모드
- 약 16메가픽셀 원본 해상도 출력
- 최대 16개 참조 이미지 조합
- 1:3~3:1 종횡비 지원
- 오픈 웨이트로 로컬 실행 가능
- 길고 밀도 높은 텍스트 렌더링
제공 업체
제공 업체별 API 요금을 비교하세요. 공급자를 선택하면 전체 요금과 적용 조건을 확인할 수 있습니다.
| 가동률 | |
|---|---|
과거 통계는 실시간 상태 확인이 아닙니다. 데이터 누락이 장애를 뜻하지는 않습니다.
Quick Start
이미지 작업을 제출하고 상태를 조회한 뒤 이미지를 저장합니다. curl과 Python 3 표준 라이브러리만 사용합니다.
POST https://openapi.felo.ai/api/v1/images/generations
1API key 설정
Felo API Platform 계정에서 key를 만들고 환경 변수로 설정하세요.
export FELO_API_KEY="YOUR_API_KEY"2첫 요청 보내기
선택 매개변수 값은 모델마다 달라 예제에서는 지정하지 않습니다. 추가 전에 Playground에서 확인하세요. 필드는 input 안이 아닌 model, prompt와 같은 수준에 둡니다.
curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-o created.json \
-d '{
"prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
"model": "minimax-h3-image-highspeed"
}'3작업 폴링
제출 후 task_id가 반환됩니다. queued 또는 running이면 3초마다 조회하고 succeeded, failed, interrupted이면 멈춥니다. 최대 30분 대기합니다. created.json을 보관하면 재제출 없이 같은 작업을 계속 조회할 수 있습니다.
python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen
task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800
while task["status"] in ("queued", "running"):
if time.monotonic() >= deadline:
raise TimeoutError(f"Keep task_id={task_id} to resume polling")
time.sleep(3)
with urlopen(Request(url, headers=headers), timeout=60) as response:
task = json.load(response)
if task.get("task_id") != task_id or task.get("kind") != "image":
raise ValueError("Unexpected task response")
print(task["status"])
if task["status"] != "succeeded":
raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY4출력 다운로드
성공하면 task.json의 outputs를 저장합니다. HTTPS URL, URL 객체, b64_json을 지원합니다. 서명 URL은 즉시 다운로드하세요. 이미지 다운로드에는 API Key가 필요하지 않습니다.
python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen
task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}
for index, output in enumerate(task["outputs"], 1):
item = output if isinstance(output, dict) else {}
url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
mime = item.get("media_type") or "image/png"
if url and url.startswith("https://"):
with urlopen(url, timeout=60) as response:
data = response.read()
mime = response.headers.get_content_type()
elif url and url.startswith("data:image/") and ";base64," in url:
header, encoded = url.split(",", 1)
mime = header[5:].split(";", 1)[0]
data = base64.b64decode(encoded, validate=True)
elif item.get("b64_json"):
data = base64.b64decode(item["b64_json"], validate=True)
else:
raise ValueError("Unrecognized image output")
path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
path.write_bytes(data)
print(path)
PYinput_references
이미지 편집 시 예제 URL을 본인의 HTTPS 이미지 URL 또는 base64 이미지 data URL로 바꾸세요. 한 번 제출한 후 동일한 조회 및 저장 단계를 따릅니다.
curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-o created.json \
-d '{
"prompt": "Keep the product and framing. Replace the background with a sunlit marble countertop.",
"model": "minimax-h3-image-highspeed",
"input_references": [
{
"type": "image_url",
"image_url": {
"url": "https://example.com/product.png"
}
}
]
}'지원 매개변수
- n
- size
- resolution
- aspect_ratio
- output_format
- input_references
전체 레퍼런스가 필요하신가요?
API 문서 →자주 묻는 질문
모델 소개: MiniMax H3 Image Highspeed?
MiniMax H3 Image Highspeed는 MiniMax H3 Image 라인업에서 속도를 최적화한 변형 모델입니다. 텍스트 프롬프트로 이미지를 생성하거나 기존 이미지를 편집할 수 있으며, 한 번의 생성에 최대 16개의 참조 이미지를 조합할 수 있습니다. 긴 프롬프트를 읽고 길고 밀도 높은 텍스트를 이미지에 렌더링하는 기능을 갖춘 오픈 웨이트 모델입니다. Highspeed 모드는 표준 모드보다 3~4배 빠르며, 표준 모드는 일부 경쟁 모델보다 1.5~2배 빠릅니다. 약 16메가픽셀의 원본 해상도로 이미지를 출력하고 1:3부터 3:1까지의 종횡비를 지원하며, 표준 버전과 동일한 파라미터와 제한을 사용합니다. 비교적 낮은 사양의 하드웨어에서도 로컬 실행이 가능합니다. 포스터, 인포그래픽, UI 화면, 마케팅 자료 제작과 신속한 프로토타이핑, 배치 처리에 적합합니다. 복잡한 구도와 다중 요소 장면 구성, 캐릭터 일관성이 필요한 작업에도 활용할 수 있습니다. 다만 32배 공간 압축으로 인해 특정 해상도에서 상당히 흐려질 수 있고 세밀한 디테일이 부족할 수 있으며, 32b 텍스트 인코더로 인해 모델이 무겁습니다.
사용 요금은 어떻게 계산되나요?
이용하는 제공 업체의 요금과 실제 사용량에 따라 비용이 결정됩니다. 긴 입력 등에는 다른 요금이 적용될 수 있습니다. 실제 생성 비용을 기준으로 과금됩니다. 최종 금액은 청구 내역을 확인하세요.
어떤 입력을 지원하나요?
텍스트 입력과 이미지 입력을 받아 이미지를 출력합니다. 기존 이미지를 편집하거나 최대 16개의 참조 이미지를 한 번의 생성에 조합할 수 있습니다.
표준 버전과 무엇이 다른가요?
Highspeed 모드는 표준 모드보다 3~4배 빠른 속도 최적화 변형입니다. 표준 버전과 동일한 파라미터와 제한을 사용합니다.
어떤 작업에 적합한가요?
포스터, 인포그래픽, UI 화면, 마케팅 자료 제작과 신속한 프로토타이핑, 배치 처리에 적합합니다. 복잡한 구도와 캐릭터 일관성이 필요한 장면에도 활용할 수 있습니다.
출력 해상도와 종횡비는 어떻게 되나요?
약 16메가픽셀의 원본 해상도로 이미지를 출력하며, 1:3부터 3:1까지의 종횡비를 지원합니다.
로컬에서 실행할 수 있나요?
오픈 웨이트 모델로 비교적 낮은 사양의 하드웨어에서도 로컬 실행이 가능합니다. 다만 32b 텍스트 인코더로 인해 모델이 무겁습니다.