소개
호스팅 생성기는 프롬프트와 선택 사항인 화면비, 해상도 단계, 파일 형식을 받습니다. 기본 결과는 1k PNG입니다.
| 항목 | 값 |
|---|---|
| 입력 | 텍스트 |
| 출력 | 이미지 |
| 배포사와 모델 | MiniMax의 H3-Image, 정지 이미지 생성 및 참조 편집용 |
| 필수 프롬프트 | 자세한 영어 설명, 최대 5,000자 |
| 해상도 단계 | 1k(기본값, 약 100만화소), 2k(약 400만화소), 4k(약 1,600만화소) |
| 생성 요금 규칙 | 1k와 2k는 같은 요금, 4k는 그 3배 |
| 캔버스 화면비 | 3:1부터 1:3까지 15가지(1:1, 16:9, 9:16, 21:9, 4:5 포함) 또는 픽셀 단위 custom 크기 |
| 출력 인코딩 | 기본 PNG, JPEG와 WebP도 지원하며 형식에 따른 요금 차이 없음 |
| 편집 입력 | 1~16장, 업로드 순서대로 image 1, image 2 등으로 참조 |
| 지원 입력 형식 | JPEG, PNG, WebP, HEIC, HEIF |
| 입력 치수 | 각 변 128~8192픽셀, 긴 변은 짧은 변의 최대 4배 |
| 화면비 생략 시 | 텍스트 생성은 1:1, 편집은 참조와 프롬프트를 바탕으로 모델이 선택 |
| 제공하지 않는 제어 항목 | 네거티브 프롬프트, 가이던스, 샘플링 스텝 |
| 실측 화소 치수 | 1k 1:1: 1024 x 1024; 2k 16:9: 2720 x 1536; 4k 1:1: 4096 x 4096; 4k 16:9: 5472 x 3072 |
핵심 기능 및 하이라이트
장면 안에 적힌 Room 1207
2k, 3:2 결과에는 검은 실크 슬립을 입고 호텔 시트 위에 누운 여성이 ‘Room 1207, midnight’이라고 읽히는 메모를 들고 있습니다. 부드러운 아침빛의 사진 장면에서도 요청한 문구가 유지됐습니다. 짧은 손글씨 한 줄을 살펴보는 샘플이며 긴 글의 안정적인 표현을 입증하지는 않습니다.
클럽 분위기에 어울리는 글자
클럽 이미지에는 MIDNIGHT JAZZ 간판이 읽을 수 있게 나타나고, 별도 향수 테스트에서는 라벨에 NOIR 07이 표현됐습니다. 모두 장면 안에 배치된 짧은 문구입니다. 직접 작성할 때는 문구를 따옴표로 감싸고 놓일 표면을 지정한 후 반환된 글자를 하나씩 확인합니다.
공간과 대상에 각각 역할을 줍니다
가구가 있는 방 예시는 두 참조의 목적을 분명히 보여 줍니다. 하나는 공간을, 다른 하나는 개를 제공합니다. 구도 테스트에서는 한 사진의 사물이나 인물을 다른 장면으로 옮기는 데 성공했습니다. 업로드 순서로 원본을 부르고 장소의 어떤 요소를 유지할지 설명합니다.
원본 사물에서 바꿀 부분을 설명합니다
운동화 예시는 요청한 배색과 원본 형태 및 바닥 유지 지시를 함께 사용합니다. 제품 편집을 작성할 때 이처럼 변경과 유지를 구분합니다. 생성 후 사물을 원본과 대조합니다. 세부 요소 보존 지시는 확인할 목표이며 이미지가 그대로 유지된다는 보장은 아닙니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수 장면 설명으로 최대 5,000자까지 입력합니다. 기본 문구나 별도의 프롬프트 요금은 없습니다. 1자 이상 · 5000자 이하 |
aspect_ratio | 아니요 | 기본값은 1:1이며 1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9 외에 width와 height로 정확한 픽셀 크기를 정하는 custom을 선택할 수 있습니다. 화면비는 생성 요금에 영향을 주지 않습니다. |
width | 아니요 | aspect_ratio가 custom일 때만 쓰는 출력 너비(픽셀)로 468 |
height | 아니요 | aspect_ratio가 custom이면 width와 함께 반드시 지정하는 출력 높이(픽셀)로 468~7,745입니다. 같은 면적 범위와 3:1 형태 제한이 적용되며 요금은 선택한 resolution으로 정해집니다. |
resolution | 아니요 | 해상도 단계는 기본 1k가 약 1 MP, 2k가 약 4 MP, 4k가 약 16 MP입니다. 1k와 2k는 요금이 같고 4k는 3배입니다. |
enable_prompt_expansion | 아니요 | 기본값 true에서는 MiniMax가 장면을 먼저 더 긴 영어 설명으로 다시 씁니다. 인용한 라벨을 입력한 그대로 남겨야 할 때처럼 원문을 그대로 쓰려면 false로 설정합니다. 기본값: |
output_format | 아니요 | 생성 파일 형식은 png, jpeg, webp 중 선택합니다. 기본값은 png이며 형식에 따라 요금이 달라지지 않습니다. |
seed | 아니요 | 0~2,147,483,647 범위의 선택 정수로 요금에 영향이 없습니다. MiniMax는 프롬프트 확장이 꺼져 있을 때만 시작점을 재사용하므로 나란히 비교할 때는 enable_prompt_expansion을 false로 두고 고정 seed를 함께 씁니다. |
요금
성공한 이미지마다 과금합니다. 1k와 2k는 같은 요금이며 4k는 그 3배입니다. 생성 실패에는 요금이 없습니다.
| 사양 | 요금 |
|---|---|
| $0.036 / 장 |
| $0.036 / 장 |
| $0.108 / 장 |
활용 사례
메모 문구를 중심으로 구성한 인물 사진
인물, 조용한 방, 카드에 쓸 정확한 문구를 설명합니다. Room 1207 예시는 2k, 3:2에서 요청한 손글씨 메시지를 읽을 수 있게 반환했습니다. 자세와 조명뿐 아니라 문구도 중요한 장면을 계획할 때 구체적인 출발점이 됩니다.
제품 이미지 속 짧은 라벨
필요한 문구를 짧게 작성하고 병 라벨처럼 특정 표면에 연결합니다. NOIR 07 결과는 글자가 읽혔고 MIDNIGHT JAZZ 장면의 간판도 선명했습니다. 사진 안에 긴 글을 넣기보다 짧은 문구를 확인하는 용도로 참고합니다.
의상과 장소 변경
사용이 허용된 인물 사진을 편집기에 넣고 새 의상이나 장소를 설명하며 인물 유지 지시를 별도로 적습니다. 단일 이미지 변경 테스트에서는 얼굴을 알아볼 수 있었습니다. 각 결과를 확인한 뒤 원본의 후속 이미지로 채택합니다.
다른 장면으로 옮긴 인물이나 사물
한 입력은 인물이나 사물에, 다른 입력은 옮길 환경에 사용합니다. 두 사진을 결합한 테스트에서는 이 역할을 성공적으로 합쳤습니다. 업로드에 번호를 붙이면 옮길 대상과 이를 배치할 장면을 지시에서 구분할 수 있습니다.
가로 장면과 정사각형 구도
배치할 용도에 맞춰 화면비를 고른 뒤 화소 단계를 별도로 설정합니다. 실측에는 2k 16:9의 2720 x 1536, 4k 1:1의 4096 x 4096, 4k 16:9의 5472 x 3072가 포함됩니다. 단계가 고정된 너비를 정하지는 않습니다.
프롬프트 가이드 및 실전 팁
생성과 편집을 선택합니다
문장으로 설명한 장면은 text-to-image로 시작하고 기존 사진을 반영하려면 image-to-image를 사용합니다. 편집 입력의 인물은 사용 권한이 있는 성인 사진을 사용하며 사칭을 피합니다.
원하는 이미지를 설명합니다
인물이나 사물, 의상, 분위기, 장소, 조명을 연결된 영어 문장으로 5,000자 이내에 작성합니다. 편집에서는 image 1, image 2와 이후 업로드를 지정한 다음 바꿀 부분과 남길 세부 요소를 명시합니다.
화면비, 크기, 파일 형식을 설정합니다
15가지 화면비와 1k, 2k, 4k 중 선택합니다. 1k와 2k의 생성 요금은 같고 4k는 그 3배입니다. 기본 형식은 PNG이며 JPEG와 WebP도 형식에 따른 추가 요금 없이 제공합니다.
반환된 세부 요소를 살펴봅니다
따옴표 안의 문구를 프롬프트와 대조하고 편집된 얼굴이나 사물을 원본과 비교합니다. 선택한 결과와 설정을 저장한 뒤 지시의 한 부분을 바꿔 다시 실행합니다.
문장으로 설명한 장면을 정지 이미지로 생성
MiniMax H3-Image text-to-image는 원본 업로드 없이 사진을 만듭니다. 에디토리얼 인물 사진, 제품 장면, 짧은 메시지가 있는 구도에 사용합니다. 영어 설명으로 장면을 정하고 화면비, 화소 단계, 인코딩은 별도 파라미터로 선택합니다. 기본 요청은 정사각형 1k PNG를 반환합니다.
이 엔드포인트의 파라미터
| 파라미터 | 허용 값과 동작 |
|---|---|
prompt | 필수 영어 장면 설명, 최대 5,000자 |
aspect_ratio | 기본 1:1, 아래 15가지 화면비 지원 |
resolution | 기본 1k, 또는 2k, 4k로 생성 단계 변경 |
output_format | 기본 png, jpeg와 webp도 형식 추가 요금 없이 선택 가능 |
seed | 0~2,147,483,647 범위의 선택 정수, 프롬프트 확장이 꺼져 있을 때만 시작점을 재현 |
enable_prompt_expansion | 기본 true, MiniMax가 설명을 더 자세한 영어 프롬프트로 다시 씀. false면 원문 그대로 사용 |
width, height | aspect_ratio가 custom일 때만 사용, 각 468~7,745픽셀, 면적은 선택한 단계 안에 맞춤 |
이미지 비율은 다음 값으로 지정할 수 있습니다: 1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9. 세로 인물 사진과 가로 공간 사진은 같은 해상도 단계에서도 치수가 다릅니다. 구도 지시와 캔버스가 일치하도록 aspect_ratio를 정합니다. 전달 위치가 1920 x 1080처럼 정확한 픽셀 크기를 요구하면 custom을 선택합니다. 1k와 2k는 450만 화소까지, 4k는 그보다 큰 2,000만 화소까지의 면적을 다룹니다.
화소 단계와 과금
반환 이미지마다 생성 요금을 부과합니다. 1k와 2k는 각각 약 100만, 400만화소지만 요금은 같습니다. 4k는 이 공통 요금의 3배입니다. JPEG, PNG, WebP에 동일한 요금 규칙을 적용합니다. 요청 전 MiniMax H3-Image 모델 페이지에서 현재 요금을 확인합니다. 생성 실패에는 과금하지 않습니다.
정사각형 실측은 1k에서 1024 x 1024, 4k에서 4096 x 4096이었습니다. 16:9는 2k에서 2720 x 1536, 4k에서 5472 x 3072였습니다. 단계는 대략적인 면적 등급이며 모든 이미지의 한 변이 4096픽셀이라는 뜻은 아닙니다.
눈에 보이는 선택을 중심으로 프롬프트 작성
MiniMax는 H3-Image에 전체 사진을 자세히 설명하는 영어 문장을 권장합니다. 등장 인물이나 사물부터 적고 의상이나 소재, 장소, 분위기, 조명을 자연스러운 문장으로 연결합니다. 인물은 30대 이상으로 지정합니다. 비 오는 창가의 회색 수염 남성과 어두운 돌 위의 호박색 병은 서로 다른 지시가 필요하므로 외형을 결정하는 세부 사항을 적습니다.
글자는 정확한 문구를 따옴표로 감싸고 사물에 연결합니다. 예를 들어 부드러운 아침빛 속에서 카메라를 향해 든 손글씨 카드에 ‘Room 1207, midnight’이라고 쓰도록 합니다. 짧고 확인 가능한 요구입니다. 한 샘플의 가독성만으로 문단 수준의 표현을 가정하지 말고 반환 문구를 프롬프트와 대조합니다.
다음 순서로 수정할 수 있습니다.
- 프롬프트, 선택 화면비, 단계, 반환 이미지를 함께 저장합니다.
- 대상, 요청 문구, 배치를 나눠 살펴봅니다.
- 빛의 방향이나 라벨 위치 등 구체적인 요소를 바꿉니다.
- 다음 결과가 채택한 방향에 맞는지 비교한 후 다시 변경합니다.
enable_prompt_expansion을 false로 바꾸지 않으면 프롬프트 확장이 켜져 있습니다. 켜져 있는 동안에는 MiniMax가 그리기 전에 설명을 다시 쓰므로 같은 seed라도 다른 이미지가 나올 수 있습니다. 통제된 비교가 필요하면 확장을 끄고 seed를 고정한 채 한 번에 한 표현만 바꿉니다. seed는 비교를 돕는 수단이며 동일한 이미지를 보장하지 않습니다. 네거티브 프롬프트, 가이던스, 샘플링 스텝은 없으므로 시각적 요구는 본문 설명에 담습니다.
샘플과 테스트에서 확인한 결과
새 Room 1207 샘플은 2k, 3:2, PNG를 사용했습니다. 검은 실크 슬립을 입고 호텔 시트 위에 누운 여성이 요청한 ‘Room 1207, midnight’ 문구가 읽히는 메모를 들고 있습니다. 별도 테스트에서는 병 라벨 NOIR 07과 MIDNIGHT JAZZ 간판이 선명했습니다. 해당 장면의 짧은 메시지, 라벨, 간판을 확인한 결과이며 긴 글은 검증되지 않았습니다.
1k의 6개 프롬프트 비교에서는 H3-Image, Open Weights, P-H3-Image 모두 나무 간판에 ‘HOT SOUP 3 FRANCS’를 표현했습니다. 문구가 같아도 사진은 서로 달랐습니다. 이 비교에서 H3-Image는 식물 도판에 작은 라틴 문자 라벨을 더 많이 배치했고 요청한 보행자 다리 시점을 따랐습니다. 개별 관찰이며 전반적인 품질 순위를 뜻하지 않습니다.
2026년 11월 11일 모델 처리 실측은 1k에서 약 1215초, 4k에서 약 2022초였습니다. 대기와 파일 전송에는 별도 시간이 듭니다.
콘텐츠 동작의 편차
표준화한 NSFW 테스트에서는 거부가 없었고 제공된 이미지에는 모두 과금됐습니다. Very strong 텍스트 생성은 1/3회, Maximum은 6/6회 요청 결과와 일치했습니다. 명명된 수준은 테스트 기록이며 다른 요청의 결과를 보장하지 않습니다. 과금상 완화된 결과 이미지와 생성 실패는 구분합니다.
필요한 경우 관련 작업 방식 선택
원본 얼굴, 사물, 환경을 구도에 반영하려면 이 페이지의 image-to-image로 이동합니다. Open Weights는 공개 가중치를 3단계가 아닌 5단계 크기로 실행합니다. LoRA 파일 작업에는 Open Weights LoRA를 선택합니다. 각각 제어 항목과 요금이 다르며 버전 간 동일 출력은 검증되지 않았습니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/h3-image/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "1:1",
"output_format": "png"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.




























