방법 1
EvoLink API로 연동
추천: 제품 백엔드, 배치 작업, 자동화 워크플로
서버에서 EvoLink 통합 이미지 API를 직접 호출하고 모델 ID, 파라미터, 작업 큐, callback, 결과 저장을 제어합니다.
- 1실제 브리프로 Playground에서 결과와 비용 검증
- 2콘솔에서 EvoLink API 키 생성
- 3위 라우트 카드에서 작업에 맞는 모델 ID 선택
- 4작업을 제출하고 폴링 또는 HTTPS callback으로 결과 수신
MiniMax H3 Image API
EvoLink의 MiniMax H3 Image API로 텍스트 기반 생성과 최대 16장 참조 이미지 편집을 이용하세요. 1K, 2K, 4K 출력과 토큰 비용을 확인하고 하나의 API 키로 앱에 연동할 수 있습니다.
MiniMax이미지 생성사용 가능
이미지 출력 1K 토큰당 $0.0038부터
텍스트→이미지이미지 편집다중 참조 입력픽셀 크기 지정프롬프트 최적화일괄 생성
프로덕션 라우트라이브
모델 특징
최대 20MP 출력, 유연한 크기 설정, 프롬프트 최적화 내장
활용 사례
고해상도 마케팅 비주얼, 다중 참조 이미지 편집, 일괄 변형 생성
입력
텍스트 프롬프트, 선택 사항으로 참조 이미지 최대 16장
출력
요청당 최대 10장, JPEG·PNG·WebP 형식
API를 연동하기 전에 MiniMax H3 Image를 먼저 써보세요
정식 연동 전에 MiniMax H3 Image의 출력 품질을 확인하고, 요청 한 건의 토큰 비용을 추정하고, 샘플을 생성해 보세요.
이미지 태스크 생성
고정 모델 minimax-h3-image이미지 생성과 편집을 지원하며 실제 토큰 사용량에 따라 최종 청구됩니다.
참조 이미지
참조 이미지는 요청의 입력 토큰 사용량에 추가됩니다.
0/16 개 파일
크기
프롬프트와 참조 이미지를 바탕으로 모델이 화면 비율을 결정합니다. 픽셀 면적은 해상도로 정해집니다.
해상도
목표 픽셀 면적: 1K 약 1.05MP, 2K 약 4.19MP, 4K 약 16.78MP. 1K와 2K는 이미지 출력 요금이 같고, 4K는 출력 토큰이 약 4배입니다.
예상 비용 ~$0.0261.7503 크레딧
auto @ 2K · 프롬프트 최적화: 켬 · 참조 이미지: 0 · 수량: 1
최종 요금은 실제 토큰 사용량을 기준으로 합니다.
준비 완료
생성된 이미지가 여기에 표시됩니다.
기록
생성 결과는 24시간 동안 보관됩니다. 필요한 파일은 미리 다운로드하세요.
이미지 생성 작업이 여기에 표시됩니다.
MiniMax H3 Image API 요금과 이미지 한 장당 비용
텍스트 기반 생성, 참조 편집, 4K 출력의 예상 비용을 비교하세요. 이미지 출력, 참조 이미지 입력, 텍스트 입력에 각각 다른 토큰 단가가 적용되며 최종 요금은 실제 사용량을 따릅니다.
첫 테스트 비용
MiniMax H3 Image - 2K - 1:1 - 이미지 1장 - 프롬프트 최적화 끔크레딧~1.0855
이미지 1장, 프롬프트 최적화 끔, 참조 이미지 없음
예상 비용~$0.016
$10어치 크레딧으로 약 598회 테스트할 수 있습니다.
Playground에서 이 예상 비용을 그대로 확인하려면 크기는 비율 1:1, 해상도는 2K로 선택하고 프롬프트 최적화를 끈 뒤, 참조 이미지 없이 프롬프트 “Cat”로 이미지 1장을 생성하세요. 프롬프트가 길어지거나 프롬프트 최적화·참조 이미지를 사용하면 입력 비용이 늘어납니다. 최종 요금은 실제 사용량에 따라 청구됩니다.
MiniMax H3 Image 테스트 예산 가이드
예상 테스트 횟수에 맞춰 금액을 선택하세요.$10
약 598회 테스트
첫 검증에 적합합니다.
$50
약 3132회 테스트
프롬프트 반복 테스트에 적합합니다.
$100
약 6264회 테스트
프로덕션 연동 전 테스트에 적합합니다.
MiniMax H3 Image 비용 예시
텍스트-이미지 생성, 최적화 켬2K - 이미지 1장 - 프롬프트 최적화 켬
~$0.026/장
~1.7109 cr/장텍스트-이미지 생성, 최적화 끔2K - 이미지 1장 - 프롬프트 최적화 끔
~$0.016/장
~1.0853 cr/장4K 텍스트-이미지 생성4K - 이미지 1장 - 프롬프트 최적화 켬
~$0.074/장
~4.9668 cr/장참조 이미지로 편집2K - 이미지 1장 - 참조 이미지 1장
~$0.041/장
~2.7615 cr/장각 예상 비용은 현재 요금으로 이미지 1장을 생성하는 기준이며, 직접 입력한 프롬프트 텍스트의 토큰은 포함하지 않습니다. 최종 요금은 실제 토큰 사용량에 따라 청구됩니다.
MiniMax H3 Image 요금
요금은 1K 토큰 기준입니다. 계산기는 요청 전체의 비용을 추정하며, 최종 요금은 실제 사용량에 따라 청구됩니다.
MiniMax H3 Image토큰 기준
minimax-h3-image이미지당 고정 가격은 없습니다. 비용은 출력 크기, 프롬프트 최적화, 참조 이미지, 생성 이미지 수에 따라 달라집니다.
| 항목 | 과금 대상 | 요금 |
|---|---|---|
| 이미지 출력 | 생성 이미지 1장당 토큰: 1K·2K는 약 4,200, 4K는 약 16,800. 2K를 넘는 픽셀 지정 크기는 너비 × 높이 ÷ 1,024로 계산합니다. | $0.0038/1K tokens0.2584 cr/1K tokens |
| 이미지 입력 | 편집 시 참조 이미지: 참조 이미지 1장당 약 10,300 토큰이며, 생성 이미지 1장마다 한 번씩 계산합니다. | $0.0015/1K tokens0.102 cr/1K tokens |
| 텍스트 입력 | 입력한 프롬프트에 더해, 프롬프트 최적화가 켜져 있으면 생성 이미지 1장마다 약 4,000 토큰이 추가됩니다. | $0.0023/1K tokens0.1564 cr/1K tokens |
이미지 출력
생성 이미지 1장당 토큰: 1K·2K는 약 4,200, 4K는 약 16,800. 2K를 넘는 픽셀 지정 크기는 너비 × 높이 ÷ 1,024로 계산합니다.
$0.0038/1K tokens0.2584 cr/1K tokens
이미지 입력
편집 시 참조 이미지: 참조 이미지 1장당 약 10,300 토큰이며, 생성 이미지 1장마다 한 번씩 계산합니다.
$0.0015/1K tokens0.102 cr/1K tokens
텍스트 입력
입력한 프롬프트에 더해, 프롬프트 최적화가 켜져 있으면 생성 이미지 1장마다 약 4,000 토큰이 추가됩니다.
$0.0023/1K tokens0.1564 cr/1K tokens
EVOLINK · 예상 비용minimax-h3-image
× 1 · 실시간제출할 때 미리 홀드되는 예상 금액입니다. 최종 요금은 실제 토큰 사용량에 따라 청구됩니다.
예상 비용
~$0.0261.7109 cr
$10당
≈ 379 장
자동 · 2K · 프롬프트 최적화: 켬
토큰 수(이미지당 × 이미지 수)
이미지 출력4,200 × 1 = 4,200
이미지 입력0 × 1 = 0
텍스트 입력4,000 × 1 = 4,000
크기
화면 비율은 프롬프트와 참조 이미지를 바탕으로 모델이 정합니다. 출력 면적은 해상도 설정에 따라 정해집니다.
해상도
생성 이미지 수
1
참조 이미지
0
프롬프트 최적화
size가 auto이거나 요청에 참조 이미지가 있으면 프롬프트 최적화는 항상 켜져 있습니다.
프롬프트
0 / 32,000자
과금 안내
- 1K와 2K는 이미지 출력 토큰 수가 같아 출력 부분의 요금이 같습니다. 전체 요청 비용에는 텍스트와 참조 이미지 입력 요금도 포함됩니다.
- 4K의 이미지 출력 토큰은 2K의 약 4배입니다.
- 텍스트 입력과 참조 이미지 입력은 생성 이미지 1장마다 한 번씩 과금되므로, 전체 예상 비용은 생성 이미지 수(n)에 비례해 늘어납니다.
- 표시된 금액은 제출할 때 미리 홀드되는 예상 금액입니다. 최종 요금은 작업의 실제 사용량에 따라 정해지며, 차액은 환불되거나 추가로 청구됩니다.
- 실패한 작업은 전액 환불됩니다. 요청한 이미지 중 일부만 성공하면 전달된 이미지에 대해서만 과금됩니다.
MiniMax H3 Image API가 지원하는 기능
MiniMax H3 Image는 MiniMax의 이미지 생성·편집 모델입니다. EvoLink 통합 API 경로를 통해 제품 장면, 캠페인 소재, 콘셉트 탐색에 활용할 수 있으며 최대 16장 참조 이미지와 한 장당 최대 2,000만 픽셀을 지원합니다. 프로덕션에 쓰기 전에 제작 요건에 맞는지 결과를 검토하세요.
모델 ID minimax-h3-image 하나로 두 가지 모드를 모두 사용합니다. 프롬프트만 보내면 텍스트-이미지 생성, image_urls를 추가하면 참조 이미지 편집입니다. 요청은 비동기 작업으로 실행되며 토큰 기준으로 과금됩니다.
모드: 텍스트-이미지 생성, 이미지 편집 · 과금: 토큰 기준: 이미지 출력, 참조 이미지 입력, 텍스트 입력 · 결과 전달: 비동기 작업, 결과 링크는 24시간 동안 유효
입력
텍스트 프롬프트 + 참조 이미지 최대 16장
출력
이미지 1~10장 · JPEG / PNG / WebP
크기
자동 / 비율 / 픽셀 지정, 최대 20MP
해상도
1K / 2K / 4K(기본값 2K)
모델 ID
minimax-h3-image
MiniMax H3 Image 모델 ID와 모드
MiniMax H3 Image
minimax-h3-imagePOST /v1/images/generations에서 텍스트-이미지 생성과 이미지 편집을 하나의 모델 ID로 처리합니다. 프롬프트를 보내면 생성하고, image_urls에 참조 이미지 1~16장을 추가하면 편집합니다. 응답으로는 완성된 이미지가 아니라 작업 ID가 반환됩니다.
MiniMax H3 Image 기능과 제어 옵션
MiniMax H3 Image 텍스트-이미지 생성
최대 32,000자의 프롬프트를 보내면 이미지 1~10장을 받습니다. size를 auto로 두면 모델이 프롬프트를 바탕으로 화면 비율을 정합니다.
MiniMax H3 Image 참조 이미지 편집
image_urls에 이미지 URL 1~16개를 넣고, 프롬프트에서 각 이미지를 "image 1", "image 2"로 지칭하며 변경 내용을 설명하세요. 편집도 같은 모델 ID로 처리하며, 참조 이미지 1장마다 이미지 입력 토큰이 추가됩니다.
MiniMax H3 Image 크기: auto, 비율, 픽셀 지정
auto를 쓰면 모델이 화면 비율을 고릅니다. 비율 X:Y는 1~300의 정수로 쓰며 1:3에서 3:1 사이여야 합니다. 픽셀 지정 WxH는 총 픽셀 수 655,360~20,000,000 범위에서 쓸 수 있고, 확대·축소나 반올림 없이 그대로 생성됩니다.
MiniMax H3 Image 해상도 단계: 1K, 2K, 4K
resolution은 auto 또는 비율 지정 시 출력 면적을 정하며 기본값은 2K입니다. 정확한 픽셀 크기를 지정하면 무시됩니다. 1K와 2K의 이미지 출력 토큰 요금은 같고, 4K는 약 네 배의 출력 토큰을 사용합니다. 전체 비용에는 텍스트와 참조 이미지 입력도 포함됩니다.
MiniMax H3 Image 프롬프트 최적화
기본으로 켜져 있습니다. 모델이 프롬프트를 상세한 프롬프트로 다시 작성하고, 실제로 사용한 프롬프트를 각 이미지와 함께 반환합니다. 비율이나 픽셀 지정 크기를 쓰는 텍스트-이미지 생성에서만 끌 수 있으며, auto 크기이거나 참조 이미지가 있으면 항상 켜져 있습니다.
n으로 MiniMax H3 Image 일괄 생성
n을 1~10으로 설정하면 요청 한 번으로 여러 장을 받을 수 있습니다. 텍스트 입력과 참조 이미지 입력은 생성 이미지 1장마다 한 번씩 과금되므로 비용은 n에 비례해 늘어납니다.
MiniMax H3 Image 주요 요청 파라미터
POST /v1/images/generations에서 출력과 비용을 좌우하는 필드입니다. 생성은 비동기로 진행되므로 반환된 작업 ID를 폴링하거나 콜백을 사용하세요. 이미지 링크는 24시간 동안만 유효하니 결과를 바로 저장해 두세요. 전체 스키마와 코드 예시는 API 탭에 있습니다.
| 파라미터 | 타입 | 역할 |
|---|---|---|
| model | string · 필수 | 항상 'minimax-h3-image'입니다. 텍스트-이미지 생성과 이미지 편집에 같은 ID를 사용합니다. |
| prompt | string · 필수 | 생성할 내용, 또는 참조 이미지를 편집하는 방법. 최대 32,000자이며, prompt_extend를 끄면 앞부분 약 4,096 토큰만 반영됩니다. |
| size | string · 기본값 auto | 'auto', 비율 X:Y(1~300의 정수, 1:3에서 3:1 사이), 또는 총 픽셀 수 655,360~20,000,000의 픽셀 지정 WxH. 범위를 벗어난 값은 400을 반환하며, 확대·축소나 반올림은 하지 않습니다. |
| resolution | string · 1K / 2K / 4K | auto와 비율 크기의 출력 면적. 기본값은 2K이며 픽셀 지정에서는 무시됩니다. 1K와 2K는 이미지 출력 토큰 수가 같고, 4K는 약 4배를 사용합니다. |
| prompt_extend | boolean · 기본값 true | 프롬프트 최적화. false는 비율이나 픽셀 지정 크기를 쓰는 텍스트-이미지 생성에서만 허용되며, size가 auto이거나 image_urls가 있으면 400을 반환합니다. |
| n | integer · 1~10 | 요청당 이미지 수. 기본값은 1입니다. 텍스트 입력과 참조 이미지 입력은 생성 이미지 1장마다 한 번씩 과금됩니다. |
| image_urls | array · 최대 16장 | 편집용 참조 이미지. jpg, jpeg, png, webp, heic, heif를 지원하며, 각 변은 128~8192 px, 긴 변은 짧은 변의 최대 4배, 장당 최대 64 MB입니다. 한 장마다 이미지 입력 토큰이 추가됩니다. |
| output_format | string · jpeg / png / webp | 결과 파일 형식. 기본값은 jpeg이며, 투명 배경은 지원하지 않습니다. |
| callback_url | string · 선택 | 작업 결과를 받는 HTTPS 웹훅. 폴링 대신 사용할 수 있습니다. |
MiniMax H3 Image을(를) 사용하는 두 가지 방법: EvoLink API 또는 Agent
제품 연동과 배치 작업에는 EvoLink API를 사용하고, 빠른 제작·개발 작업에는 Codex, Claude 또는 Gemini에서 Agent로 호출할 수 있습니다. 두 방식은 동일한 EvoLink API 키, 잔액, 모델 라우트, 작업 기록을 공유합니다.
방법 2
Agent로 호출
추천: Codex, Claude, Gemini의 제작 및 개발 작업
생성 목표, 자료, 검수 조건을 Agent에 전달하면 라우트 선택, 요청 구성, 작업 추적, 결과 반환까지 맡길 수 있습니다. 각 단계를 직접 코딩할 필요가 없습니다.
- 1EVOLINK_API_KEY를 로컬 환경 변수로 설정하고 코드나 Prompt에 넣지 않기
- 2출력 목표, 참조 자료, 핵심 파라미터 설명
- 3Agent가 MiniMax H3 Image 라우트를 호출하고 task ID를 저장하도록 요청
- 4최종 상태 확인, 결과 다운로드, 실패 원인 보고를 Agent에 맡기기
MiniMax H3 Image로 할 수 있는 일
제품 장면과 캠페인 소재
캠페인 키 비주얼, 배너, 제품 장면을 4K 단계로 생성하세요. 게재 위치에 특정 크기가 필요하면 최대 약 20MP까지 픽셀을 직접 지정할 수 있습니다.
제품·장면·스타일 참조 이미지를 활용한 편집
제품 사진, 배경, 스타일 샘플 등 참조 이미지를 한 요청에 최대 16장까지 조합하고, image 1, image 2처럼 지칭해 각 이미지를 어떻게 쓸지 모델에 알려 주세요.
여러 후보를 생성해 검토
n으로 같은 프롬프트에서 최대 10장을 요청한 뒤 발전시킬 만한 이미지를 고르세요. 일부 이미지가 차단되더라도 작업은 나머지를 반환하며 그 이미지만 과금됩니다.
고정 픽셀 크기에 맞춘 이미지
슬라이드 배경용 1920x1080처럼 출력이 정해진 자리에 꼭 맞아야 할 때는 WxH를 전달하세요. 허용 범위 안의 크기는 확대·축소나 반올림 없이 요청한 그대로 생성됩니다.
여러 게재 형식에 맞춘 소재
하나의 프롬프트를 1:1, 4:5, 16:9, 9:16 같은 비율에 재사용해 피드, 스토리, 배너 지면을 모두 채우세요. 1:3에서 3:1 사이라면 어떤 정수 비율이든 쓸 수 있습니다.
짧은 제작 요건을 구체적인 프롬프트로
한 줄짜리 아이디어에서 시작해 프롬프트 최적화로 확장하세요. 실제로 사용된 프롬프트가 각 이미지와 함께 반환되므로 검토하고 다듬어 다시 쓸 수 있습니다.
MiniMax H3 Image API 코드 예제와 오류 처리
가장 짧은 실행 흐름을 보여 줍니다. 작업을 생성하고 반환된 task ID를 저장한 다음 폴링하거나 HTTPS callback을 기다립니다. 전체 파라미터와 응답 구조는 API 탭에서 확인하세요.
cURL
curl -X POST https://api.evolink.ai/v1/images/generations \
-H "Authorization: Bearer $EVOLINK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-image",
"prompt": "A colorful sunset over the ocean, painterly style",
"size": "16:9",
"resolution": "2K",
"n": 1,
"callback_url": "https://your-domain.com/webhooks/image-task-completed"
}'
# Save the returned task ID, then query:
curl https://api.evolink.ai/v1/tasks/{task_id} \
-H "Authorization: Bearer $EVOLINK_API_KEY"이 요청에서는 프롬프트 최적화를 끌 수 없습니다
size가 auto이거나 image_urls가 있을 때 prompt_extend: false를 보내면 400이 반환됩니다. 텍스트-이미지 생성에서는 비율이나 픽셀 지정을 사용하거나, 프롬프트 최적화를 켠 채로 두세요. 요청은 과금 전에 거부됩니다.
크기가 허용 범위를 벗어났습니다
픽셀 지정은 총 픽셀 수가 655,360~20,000,000이어야 하고, 모든 크기는 1:3에서 3:1 사이여야 하며, 비율의 각 항은 1~300이어야 합니다. 범위를 벗어난 크기는 400을 반환하며, 자동으로 확대·축소하거나 반올림하지 않습니다.
참조 이미지가 너무 많거나 지원되지 않습니다
image_urls에 URL이 16개를 넘으면 400이 반환됩니다. 또한 각 이미지는 jpg, jpeg, png, webp, heic, heif 중 하나여야 하고, 각 변은 128~8192 px, 긴 변과 짧은 변의 비율은 최대 4:1, 크기는 64 MB 이하여야 합니다.
파라미터 검증 실패
위 파라미터 카드와 대조해 값 범위, 허용 옵션, 자료 개수, 파일 형식이 선택한 라우트 요건에 맞는지 확인하세요.
인증 또는 잔액 문제
Authorization Bearer Token을 확인하고 콘솔에서 사용 가능 잔액과 작업 과금을 확인하세요.
콘텐츠 또는 자료 거부
초상권, 브랜드 자료, 읽을 수 있는 텍스트, 민감한 콘텐츠, 입력 자료의 적합성을 확인하세요.
작업 실패 또는 시간 초과
최종 상태가 실패인 MiniMax H3 Image 작업은 과금되지 않습니다. task ID를 보관하고 검증, 심사, 실행 중 어느 단계가 원인인지 확인한 후 재시도하세요.
Callback 미수신
callback_url은 공개 HTTPS URL이어야 하며 localhost 또는 사설 네트워크를 사용할 수 없습니다. 폴링 대안으로 task ID도 보관하세요.
MiniMax H3 Image와 EvoLink의 다른 이미지 모델 비교
| 항목 | MiniMax H3 Image | GPT Image 2.6 Flare | Nano Banana 2.1 | Seedream 5.0 Pro | Grok Imagine Image 2.0 |
|---|---|---|---|---|---|
| 과금 | 토큰 기준: 이미지 출력, 이미지 입력, 텍스트 입력 | 토큰 기준 | 해상도별 장당 과금, 참조 이미지와 검색은 별도 항목 | 출력 단계별 장당 과금, 입력 이미지마다 과금 | 품질·해상도별 장당 과금 |
| 출력 해상도 | 1K / 2K / 4K 또는 최대 20MP 픽셀 지정 | 1K / 2K / 4K | 1K / 2K / 4K | 1K / 1.5K / 2K | 1K / 2K |
| 크기 옵션 | auto, 1:3~3:1 사이의 모든 비율, 또는 픽셀 지정 | auto, 15가지 비율, 또는 사용자 지정 픽셀 | auto 또는 14가지 비율 | auto, 비율, 또는 사용자 지정 픽셀 | auto 또는 13가지 비율 프리셋 |
| 참조 이미지 | 최대 16장 | 최대 16장 | 최대 14장 | 최대 10장 | 최대 3장 |
과금
MiniMax H3 Image토큰 기준: 이미지 출력, 이미지 입력, 텍스트 입력
GPT Image 2.6 Flare토큰 기준
Nano Banana 2.1해상도별 장당 과금, 참조 이미지와 검색은 별도 항목
Seedream 5.0 Pro출력 단계별 장당 과금, 입력 이미지마다 과금
Grok Imagine Image 2.0품질·해상도별 장당 과금
출력 해상도
MiniMax H3 Image1K / 2K / 4K 또는 최대 20MP 픽셀 지정
GPT Image 2.6 Flare1K / 2K / 4K
Nano Banana 2.11K / 2K / 4K
Seedream 5.0 Pro1K / 1.5K / 2K
Grok Imagine Image 2.01K / 2K
크기 옵션
MiniMax H3 Imageauto, 1:3~3:1 사이의 모든 비율, 또는 픽셀 지정
GPT Image 2.6 Flareauto, 15가지 비율, 또는 사용자 지정 픽셀
Nano Banana 2.1auto 또는 14가지 비율
Seedream 5.0 Proauto, 비율, 또는 사용자 지정 픽셀
Grok Imagine Image 2.0auto 또는 13가지 비율 프리셋
참조 이미지
MiniMax H3 Image 연동 핵심 사항
엔드포인트 하나, 모델 ID 하나
model을 minimax-h3-image로 지정해 POST /v1/images/generations를 호출하세요. 텍스트-이미지 생성과 편집은 같은 라우트를 사용하며, image_urls를 추가하면 요청이 편집으로 바뀝니다.
비동기 작업 라이프사이클
생성 호출은 작업 ID를 반환합니다. 작업이 completed 또는 failed가 될 때까지 GET /v1/tasks/{task_id}를 폴링하거나, HTTPS callback_url을 전달하세요. 결과 링크는 24시간 동안 유효하므로 필요한 파일은 저장해 두세요.
토큰 기준 과금
요금은 이미지 출력, 참조 이미지 입력, 그리고 프롬프트와 프롬프트 최적화를 포함하는 텍스트 입력의 세 가지입니다. 작업이 시작될 때 예상 금액이 홀드되고, 최종 요금은 실제 사용량에 따라 정해집니다. 실패한 작업은 전액 환불됩니다.
EvoLink로 MiniMax H3 Image를 쓰는 이유
생성 전에 비용 추정
Playground와 가격 계산기는 크기, 해상도, 프롬프트 최적화 설정, 참조 이미지, n을 바탕으로 요청 비용을 추정합니다. 이 예상 금액은 작업이 시작될 때 홀드되며, 최종 요금은 모델이 보고한 사용량에 따라 정해집니다.
실제 사용량이 예상보다 적거나 많으면 차액이 환불되거나 추가로 청구되므로, 각 작업 기록에는 요청이 실제로 사용한 만큼이 표시됩니다.
생성과 편집을 하나의 모델 ID로
minimax-h3-image는 같은 엔드포인트에서 텍스트-이미지 생성과 참조 이미지 편집을 모두 처리합니다. 텍스트 전용 프로토타입에서 편집 워크플로로 넘어갈 때는 요청에 image_urls만 추가하면 되며, 두 번째 라우트나 모델 ID를 따로 연동할 필요가 없습니다.
API 키 하나로 이미지·영상·음성·LLM 모델까지
minimax-h3-image를 호출하는 API 키로 MiniMax의 영상 모델, Nano Banana 2.1과 Seedream 5.0 Pro 같은 다른 이미지 모델, EvoLink의 텍스트 모델까지 호출할 수 있습니다. 잔액도 작업 기록도 하나로 관리됩니다.
이미지 작업에서는 파이프라인을 한곳에서 운영할 수 있다는 뜻입니다. 여기서 스틸 이미지를 생성해 영상 모델의 첫 프레임으로 쓰거나, 새 계정을 만들지 않고 같은 기획으로 다른 이미지 모델을 시험해 볼 수 있습니다.
검증할 수 있는 작업 상태
모든 작업은 pending, processing, completed, failed 중 하나의 상태를 보고하며, 실패한 작업은 전액 환불됩니다. 요청한 이미지 중 일부만 성공하면 작업은 그 이미지들로 완료되고 해당 이미지만 과금됩니다.
작업을 폴링하거나 콜백을 사용해 최종 상태를 확인하고, 작업 ID를 보관해 두면 각 청구 내역을 요청과 대조할 수 있습니다.
MiniMax 모델 제품군
EvoLink에서 제공하는 MiniMax의 영상 모델로, MiniMax H3 Image와 같은 계정과 API 키로 사용할 수 있습니다.
MiniMax H3 Max Turbo
5~15초 길이의 텍스트-영상 생성과 첫 프레임 기반 영상 생성(마지막 프레임은 선택)을 지원하는 MiniMax 영상 모델. 480p 또는 768p.
API 보기
MiniMax H3 Max
텍스트-영상, 첫 프레임 기반 이미지-영상, 그리고 이미지·영상·오디오 입력을 받는 참조 라우트를 제공하는 MiniMax 영상 모델. 480p 또는 768p, 5~15초.
API 보기
MiniMax H3 Image 외 EvoLink의 다른 이미지 모델
MiniMax H3 Image API 자주 묻는 질문
MiniMax H3 Image API의 모델 ID는 무엇인가요?
모델 ID는 minimax-h3-image이며, 소문자와 하이픈으로 씁니다. 텍스트-이미지 생성과 이미지 편집 모두 POST /v1/images/generations의 model에 이 값을 넣어 보내세요. MiniMax H3의 영상 라우트인 minimax-h3-image-to-video와는 다른 모델입니다.
MiniMax H3 Image는 어떻게 과금되나요?
토큰 기준이며 요금은 세 가지입니다. 이미지 출력, 참조 이미지 입력, 그리고 프롬프트와 프롬프트 최적화를 포함하는 텍스트 입력입니다. 작업이 시작될 때 예상 금액이 홀드되고, 최종 요금은 모델이 보고한 사용량에 따라 정해지며, 차액은 환불되거나 추가로 청구됩니다. 텍스트 입력과 참조 이미지 입력은 생성 이미지 1장마다 한 번씩 계산되므로 비용은 n에 비례해 늘어납니다. 현재 요금은 이 페이지의 가격 섹션에서 확인할 수 있습니다.
MiniMax H3 Image의 1K와 2K 이미지 출력 요금은 왜 같나요?
두 단계는 이미지 한 장당 출력 토큰 수가 같아 출력 요금이 같습니다. 전체 비용에는 프롬프트 처리와 참조 이미지 입력도 포함됩니다. 4K는 약 네 배의 이미지 출력 토큰을 사용합니다. 2K 면적을 넘는 정확한 픽셀 크기는 너비 × 높이 ÷ 1024로 출력 토큰을 계산합니다.
프롬프트 최적화는 언제 끌 수 있나요?
prompt_extend는 기본으로 켜져 있습니다. 비율이나 픽셀 지정 크기를 쓰는 텍스트-이미지 생성에서만 false로 설정할 수 있습니다. size가 auto이거나 image_urls가 있을 때 false를 보내면 과금 전에 400 오류로 거부됩니다. 자동 비율과 편집은 모두 최적화 단계에 의존하기 때문입니다. 끈 상태에서는 프롬프트의 앞부분 약 4,096 토큰만 반영됩니다.
최대 이미지 크기는 얼마이며, 픽셀을 직접 지정할 수 있나요?
출력은 최대 20,000,000픽셀, 약 20MP까지 가능합니다. 픽셀을 직접 지정하려면 size를 WxH로 전달하세요. 총 픽셀 수는 655,360~20,000,000, 화면 비율은 1:3에서 3:1 사이여야 합니다. 16의 배수여야 한다는 규칙은 없으며, 크기는 확대·축소나 반올림 없이 그대로 적용됩니다. auto나 비율을 쓸 때는 resolution으로 1K, 2K, 4K를 고릅니다. 예를 들어 16:9는 2K에서 2720×1536, 4K에서 5472×3072입니다.
참조 이미지는 몇 장까지 보낼 수 있고, 어떤 제한이 있나요?
요청당 image_urls에 최대 16장입니다. 지원 형식은 jpg, jpeg, png, webp, heic, heif이며, 각 변은 128~8192 px, 긴 변은 짧은 변의 최대 4배, 파일당 최대 64 MB여야 합니다. 프롬프트에서는 image 1, image 2처럼 지칭하세요. 편집 내용은 프롬프트로 설명하며, 마스크 기반 인페인팅과 투명 배경은 지원하지 않습니다.
요청한 이미지 중 일부가 실패하면 어떻게 되나요?
예를 들어 여러 장 중 한 장이 콘텐츠 안전 검사에서 차단되더라도, 작업은 성공한 이미지로 완료되며 그 이미지만 과금됩니다. 따라서 결과 수가 n보다 적을 수 있습니다. 작업 전체가 실패하면 전액 환불됩니다.
결과는 어떻게 받고, 링크는 얼마나 유지되나요?
생성은 비동기로 진행됩니다. 생성 호출이 작업 ID를 반환하면 상태가 completed가 될 때까지 GET /v1/tasks/{task_id}를 폴링하거나, callback_url을 설정해 HTTPS 엔드포인트로 결과를 받으세요. 결과 링크는 24시간 동안 유효하므로 보관할 이미지는 다운로드해 저장해 두세요.
MiniMax H3 Image의 4K 출력은 항상 가로 4096픽셀인가요?
4K는 4096 × 4096픽셀을 목표로 하는 출력 면적 단계이며 가로 크기가 고정된 것은 아닙니다. 실제 크기는 종횡비에 따라 달라지며 문서의 16:9 예시는 5472 × 3072입니다. EvoLink에서 auto 또는 비율 지정의 기본값은 2K이며, 정확한 픽셀 크기를 지정하면 해상도 단계보다 우선합니다.
MiniMax H3 Image API와 H3 이미지 동영상 변환은 같은 기능인가요?
아닙니다. minimax-h3-image는 정지 이미지 생성과 참조 이미지 편집을 지원합니다. minimax-h3-image-to-video는 입력과 과금이 별도인 동영상 생성 경로입니다. MiniMax 직접 API의 모델 이름과 기본값도 다를 수 있으므로 이 페이지에 명시된 EvoLink 모델 ID와 요청 옵션을 사용하세요.