소개
첫 URL이 편집할 사진을 제공하며 이후 URL은 지시문에서 <Picture 2>, <Picture 3>처럼 부르는 참조 자료입니다.
| 항목 | 값 |
|---|---|
| 입력 | 이미지 |
| 출력 | 이미지 |
| 모델과 출력 | MiniMax H3-Image 오픈웨이트, 텍스트 생성과 이미지 편집, 정지 이미지 |
| 프롬프트 한도 | 두 엔드포인트 모두 필수, 최대 5,000자 |
| 해상도 선택 | 1k 약 100만화소(기본); 1.5k 약 240만화소; 2k 약 400만화소; 3k 약 940만화소; 4k 약 1,680만화소 |
| 캔버스 비율 | 15가지: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 2:1, 1:2, 3:1, 1:3, 21:9, 9:21 |
| 화면비 기본값 | 텍스트 생성은 1:1, 편집은 |
| 편집 사진 | 1~9장, 원본 뒤에 참조 최대 8장 |
| 사진 참조 표기 | <Picture 1>은 원본, <Picture 2> 이후는 추가 참조 |
| seed 설정 | 선택 사항, 동일 화소를 보장하지 않지만 한 요소 변경 비교 지원 |
| 파일 인코딩 | jpeg(기본), png, webp, 형식에 따른 요금 차이 없음 |
| 실측 이미지 크기 | 1k 3:4: 896 x 1184; 1.5k 9:16: 1152 x 2048; 2k 3:2: 2496 x 1664; 3k 1:1: 3072 x 3072; 4k 16:9: 5472 x 3072 |
| 관찰된 모델 처리 시간 | 11월 11일 1k 오전 20 |
| 과금 기준 | 해상도 단계별 완료 이미지당 과금, 편집은 원본 다음 참조마다 추가 요금, 실패 요청 무료 |
핵심 기능 및 하이라이트
도시 윤곽과 대비되는 푸른 수영장 빛
1.5k, 3:4, seed 7의 옥상 수영장 예시에는 밤에 물에서 나오는 남성이 도시 불빛과 푸른 수영장 빛을 배경으로 보입니다. 더 큰 정사각형 아침 식사 장면과 함께 중간 단계의 인물 사진을 보여 줍니다.
중대형 단계의 테이블 장면
아침 식사 샘플은 seed 7로 빵, 무화과, 꿀, 리넨이 보이는 3072 x 3072 이미지를 반환했습니다.
해안 장면에 자전거를 탄 인물을 배치합니다
합성은 <Picture 1>의 도로와 연한 파란색 쿠페를 유지하며 <Picture 2>의 인물과 자전거를 그 옆에 놓았습니다.
흐린 날씨를 가을빛으로 바꿉니다
원본 한 장이 주황색 낙엽과 안개 낀 강이 있는 가을 다리 장면으로 바뀌었습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수 편집 설명은 최대 5,000자입니다. 원본을 <Picture 1>, 이후 참조를 으로 지정합니다. 1자 이상 · 5000자 이하 |
image_urls | 예 | URL 1~9개를 순서대로 제공하며 첫 사진이 편집 대상입니다. 기본 원본은 없습니다. 1개 이상 · 9개 이하 |
aspect_ratio | 아니요 | 화면비를 설정할 때는 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 중에서 선택합니다. 생략하면 첫 입력 이미지의 화면비를 따르며 화면비 추가 요금은 없습니다. |
resolution | 아니요 | 편집 출력 기본값은 1k입니다. 1.5k, 2k, 3k, 4k도 지원하며 각 상위 단계의 요금은 더 높습니다. |
output_format | 아니요 | 편집 결과를 jpeg(기본값), png, webp로 저장합니다. 세 형식 모두 선택한 단계의 요금을 적용합니다. |
seed | 아니요 | 편집 비교용 난수 소스를 선택적으로 지정합니다. 소스를 고정할 필요가 없으면 생략합니다. |
요금
완료된 편집에는 첫 입력을 포함한 해당 단계의 요금이 적용되며 이후 입력은 장마다 소액이 추가됩니다. 크기 단계가 높을수록 비싸고 실패한 요청에는 요금이 없습니다.
| 사양 | 요금 |
|---|---|
| $0.024 / 장 |
| $0.042 / 장 |
| $0.06 / 장 |
| $0.132 / 장 |
| $0.204 / 장 |
활용 사례
분위기가 분명한 야간 인물 사진
인물, 행동, 광원을 중심으로 에디토리얼 장면을 구성합니다. 옥상 수영장 예시는 1.5k, 3:4, seed 7로 도시 불빛과 푸른 수영장 빛을 배경으로 한 남성을 반환했습니다.
더 큰 크기의 테이블 배치
출력 단계를 고르기 전에 사물과 위치를 설명합니다. 3k 정사각형 아침 식사 결과는 3072 x 3072로 빵, 무화과, 꿀, 리넨을 내려다보는 구도였습니다.
원본별 역할을 나눈 합성
장소와 추가 대상을 서로 다른 사진 번호로 지정합니다. 해안 편집에서는 도로와 연한 파란색 쿠페가 남았으며 다른 참조의 자전거와 인물이 그 옆에 나타났습니다.
대상을 유지하며 계절 변경
유지할 세부 요소를 명시하면서 새 계절과 조명을 요청합니다. 다리 편집에서는 인물과 자전거를 남기고 가을 낙엽, 황금빛, 강 위의 안개를 추가했습니다.
지정한 짧은 문구의 간판
짧은 라벨이나 간판 문구를 따옴표로 묶고 장면의 어느 곳에 둘지 적습니다. 같은 프롬프트 비교에서 나무 간판의 HOT SOUP 3 FRANCS가 정확히 표현됐습니다. 긴 글은 여전히 주의 깊게 검토해야 합니다.
프롬프트 가이드 및 실전 팁
장면이나 원본에서 시작합니다
글로 적은 구상은 텍스트 생성을, 수정할 사진이 있으면 이미지 편집을 선택합니다. 편집에는 사용 권한이 있는 성인 사진을 쓰며 사칭하지 않습니다.
구도와 참조 역할을 설명합니다
장소, 대상, 의상, 빛, 카메라 시점을 연결된 영어 문장으로 적습니다. 편집에서는 원본을 <Picture 1>로 부르고 이후 참조마다 번호에 맞는 역할을 줍니다.
화면비, 단계, 파일 형식을 정합니다
1k~4k에서 해상도를 고르고 생성 화면비를 선택합니다. 편집은 비율을 주지 않으면 원본 형태를 따릅니다. 기본 JPEG 외에 PNG와 WebP도 가능합니다.
seed로 한 가지 변경을 비교합니다
seed와 나머지 설정을 고정하고 지시 하나만 바꿉니다. 결과의 세부 요소를 구상과 대조합니다. 고정 seed는 비교를 돕지만 동일 결과를 약속하지 않습니다.
번호가 붙은 참조로 원본 수정
MiniMax H3-Image Open Weights 편집기는 원본 사진과 글로 적은 변경 요청을 사용합니다. image_urls의 맨 앞에 원본을 넣고 인물, 사물, 장면 요소를 가져올 참조를 추가합니다. 편집 하나에 원본 1장과 참조 최대 8장, 총 9장을 받습니다.
해안 합성은 연한 파란색 쿠페가 있는 도로에 인물과 자전거를 가져왔습니다. 가을 편집은 원본 한 장에서 인물을 유지하며 주변을 바꿨습니다. 같은 원본·참조 제어를 다른 구상에 활용한 예시입니다.
편집 파라미터
| 파라미터 | 편집에서의 의미 | 기본값 또는 제한 |
|---|---|---|
image_urls | 순서가 있는 원본과 참조 URL | 필수, 총 1~9장 |
prompt | 변경 요청, 원본 역할, 유지 요소 | 필수, 최대 5,000자 |
aspect_ratio | 지원 캔버스 형태 | 생략 시 원본 화면비 |
resolution | 1k, 1.5k, 2k, 3k, 4k | 기본 1k, 상위 단계는 더 높은 요금 |
output_format | jpeg, png, webp | 기본 jpeg, 형식 추가 요금 없음 |
seed | 통제된 비교용 난수 소스, 선택 사항 | 동일 결과를 보장하지 않음 |
화면비는 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를 생략하고 다른 구도가 필요하면 지정합니다. 해상도는 화면비와 독립적으로 고릅니다.
사진마다 역할 지정
원본은 <Picture 1>, 다음 업로드는 <Picture 2>로 순서대로 지정합니다. 프롬프트의 토큰 번호가 URL 목록과 맞는지 확인합니다. 막연히 참조 사진이라고만 하면 기여할 요소가 불분명합니다.
합성에서는 <Picture 1>의 해안도로와 쿠페 유지, <Picture 2>의 30대 여성과 자전거를 주차한 차 옆에 추가, 오후 빛 일치, 알아볼 수 있는 얼굴과 데님 재킷 유지처럼 문장별로 역할을 나눕니다. 장소, 추가 대상, 보존 목표를 따로 설명합니다.
사용 권한이 있는 사진만 사용합니다. 입력 인물은 성인이어야 하며 누구도 사칭하지 않습니다. 이곳의 프롬프트 예시는 30대 이상을 묘사합니다.
변경과 유지 요소 함께 설명
계절이나 장소를 바꿀 때는 인물, 머리 모양, 옷, 자전거 등 남길 요소부터 적습니다. 이어 대체할 주변과 조명을 설명합니다. 돌다리 위 인물을 남기며 가을 낙엽, 황금빛 아침, 안개 낀 강을 요청할 수 있습니다. 편집 후 원본 인물과 주요 사물을 확인합니다.
다른 참조에서 사물을 가져오면 번호와 사물 이름, 배치 위치를 명시합니다. 참조 칸을 모두 채울 필요는 없습니다. 지시에서 역할을 설명할 수 있는 사진만 넣습니다.
seed로 단일 변경 비교
seed, 입력 순서, 화면비, 단계를 유지하고 계절이나 빛 방향 등 구절 하나만 바꿉니다. 결과와 입력 목록, 문구를 저장해 요청 간 차이를 남깁니다. seed는 비교용 난수 소스를 고정할 뿐 동일 화소나 모든 세부 요소의 보존을 보장하지 않습니다.
편집 테스트로 확인한 점
두 참조 해안 편집은 원본 도로를 유지하며 연한 파란색 쿠페 옆에 인물과 자전거를 배치했습니다. 한 사진의 가을 예시는 인물과 자전거를 유지하며 주황 낙엽, 황금빛, 강 안개를 추가했습니다. 의상과 장소 테스트에서도 얼굴이 유지됐습니다. 개별 관찰이므로 새 결과는 해당 원본과 각각 대조합니다.
기록된 NSFW 결과
11월 11일 저녁 편집 점검은 거부 없이 모든 요청에 이미지를 반환했고 제공 이미지에 과금했습니다. 요청대로 나온 횟수는 Mild 3/3, Moderate 2/3, Strong 2/3, Very strong 0/3, Maximum 6/6입니다. 그 외 결과는 완화됐습니다. 이미지 수신과 요청 모든 부분의 일치는 다르며 이 샘플로 이후 모든 편집을 예측할 수 없습니다.
편집 요금 계산
출력 단계가 원본을 포함한 이미지당 편집 요금을 정합니다. 원본 다음의 사진마다 소액 요금이 추가됩니다. 해상도 5단계는 각각 요금이 다르고 크기가 커질수록 오릅니다. JPEG, PNG, WebP 전환은 단계 요금을 바꾸지 않습니다. 실패 요청에는 과금하지 않습니다. 합성 제출 전 모델 페이지의 현재 요금과 입력 수를 확인합니다.
제한과 대안
네거티브 프롬프트, 가이던스, 샘플링 스텝 필드는 없습니다. 입력은 9장까지이며 출력은 영상이나 오디오가 아닌 정지 이미지입니다. 편집 성공이 얼굴, 사물 형태, 요청 문구의 완벽한 일치를 보장하지 않으므로 구상에서 지정한 요소를 살펴봅니다.
원본 없이 글에서 생성하려면 텍스트 생성을 사용합니다. LoRA 버전은 스타일 가중치 파일을 최대 3개 추가합니다. 10~16장의 입력이 필요하면 이 사진 토큰 대신 업로드 순서의 image 1, image 2를 사용하는 MiniMax H3-Image를 고려합니다. 해당 계열에는 seed가 없고 두 버전의 출력 동등성도 확인되지 않았습니다. 별도 모델인 P-H3-Image는 프롬프트와 seed가 같아도 결과를 서로 대체할 수 없습니다.
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-open/edit",
"input": {
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# 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 레퍼런스에서 확인하세요.

























