소개
스타일 가중치가 이미지 편집에 반영됩니다. <Picture 1>은 원본을, 이후 토큰은 보조 이미지를 지정합니다.
| 항목 | 값 |
|---|---|
| 입력 | 이미지 |
| 출력 | 이미지 |
| 지원 작업 | 텍스트 이미지 생성과 이미지 편집, 정지 이미지 |
| 모델 계열 | LoRA 연결을 지원하는 MiniMax H3-Image 오픈웨이트 |
| LoRA 파일 연결 | 직접 .safetensors 파일 URL 최대 3개 |
| LoRA 강도 | 파일별 0~4, 기본 1 |
| 프롬프트 길이 | 필수, 최대 5,000자 |
| 해상도 메뉴 | 1k, 1.5k, 2k, 3k, 4k, 기본 1k |
| 캔버스 선택 | 화면비 15가지, 텍스트 생성 기본 1:1 |
| 편집용 입력 | 1~9장, 편집 원본 뒤에 참조 최대 8장 |
| 참조 표기법 | 업로드 순서에 따라 <Picture 1>, <Picture 2> 이후 번호 |
| 출력 형식 | 기본 jpeg, png와 webp도 가능 |
| 비교 제어 | 선택 seed, 동일 출력 보장 없이 단일 변경 비교 지원 |
| 테스트한 출력 치수 | 1.5k 9:16: 1152 x 2048; 4k 16:9: 5472 x 3072 |
핵심 기능 및 하이라이트
캠코더 표현으로 본 네온빛
새 1k, 16:9 샘플에는 빨간 슬립 드레스 차림의 여성이 모텔 방에서 춤추는 모습이 보입니다. vh5tape와 scale 1의 VHS LoRA가 화면 전체에 부드러운 1990년대 홈비디오 느낌을 적용했습니다.
테이프 표현과 함께 따라오는 글자
식당의 춤에는 녹화 입자와 왼쪽 아래 vh5tape 글자가 있습니다. 출력 선택 전 의도한 스타일뿐 아니라 글자도 살펴봐야 하는 가시적인 흔적입니다.
부드러운 녹화 화면의 레이싱 게임기
아케이드 예시는 네온빛 속 두 플레이어에 VHS 표현을 적용합니다. 어댑터가 인물과 주변의 외형을 바꾸는 방식을 판단할 두 번째 장면입니다.
항구를 다시 그리는 방식
Studio1939 스타일 편집은 항구를 러버호스 만화 보트가 있는 흑백 그림으로 다시 그렸습니다. 이 샘플에서는 도시 윤곽 배치를 알아볼 수 있게 유지했습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 최대 5,000자의 필수 편집 지시를 LoRA 트리거 단어로 시작하고 으로 입력을 지정합니다. 기본 프롬프트나 텍스트 추가 요금은 없습니다. 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 중 선택합니다. 출력 크기 단계가 올라갈수록 요금도 높아집니다. |
loras | 아니요 | 편집에 {path, scale} 항목을 최대 3개 제공하거나 파일 연결을 생략합니다. Hugging Face /resolve/main/ 같은 .safetensors 직접 URL을 사용합니다. 기본값: |
output_format | 아니요 | 편집 결과의 기본 형식은 jpeg입니다. 동일한 단계 요금으로 png나 webp를 요청할 수 있습니다. |
seed | 아니요 | 편집 표현을 비교할 때 선택적으로 난수 소스를 유지합니다. 고정 기본값이나 수치 범위는 명시하지 않습니다. |
요금
스타일 편집에는 오픈웨이트 크기 단계 요금과 이미지당 고정 LoRA 추가 요금이 적용됩니다. 파일이 0개, 1개, 3개여도 같습니다. 첫 장 이후의 모든 입력에는 요금이 추가되며 로드 오류와 기타 실패에는 과금하지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.042 / 장 |
| $0.06 / 장 |
| $0.078 / 장 |
| $0.15 / 장 |
| $0.222 / 장 |
활용 사례
네온 모텔 장면 구상
빨간 드레스 모텔 예시는 scale 1의 VHS LoRA로 밤의 춤을 부드러운 캠코더풍 정지 이미지로 바꿉니다. 테이프 시대 무드 보드에서 전체 화면의 표현을 참고합니다.
기존 사진의 스타일 변경
1930년대 만화 LoRA는 자세를 유지하며 사진을 러버호스 만화로 바꿨습니다. 항구 예시는 도시 윤곽 배치를 유지하는 관련 편집을 보여 줍니다.
확대 전에 어댑터 비교
seed와 장면 설명을 유지하며 LoRA를 켜고 끕니다. VHS 비교에서 질감뿐 아니라 프레이밍도 바뀌었으므로 더 큰 해상도를 고르기 전 둘 다 평가합니다.
인물 사진의 장소 재구성
단일 사진의 의상·장소 편집은 테스트에서 얼굴을 유지했습니다. LoRA 적용은 별도로 비교해 인물과 주변에 미치는 영향을 판단합니다.
원본과 장면 참조 결합
두 사진 구도는 테스트에서 성공했습니다. 스타일 합성을 계획할 때 편집 원본을 장면 참조보다 앞에 놓고 지시에서 각 사진을 지정합니다.
프롬프트 가이드 및 실전 팁
생성 또는 편집으로 시작합니다
생성은 글로 적은 장면에서, 편집은 지원 참조보다 먼저 제공한 수정 원본에서 시작합니다. 편집 입력은 최대 9장입니다.
다운로드 가능한 LoRA를 연결합니다
path를 .safetensors 파일 자체로 지정하고 필요한 경우 Hugging Face /resolve/main/ 링크를 사용합니다. scale 1부터 시작합니다. 파일별 범위는 0~4이며 요청당 최대 3개입니다.
장면과 표현을 설명합니다
선택 LoRA 트리거 뒤에 의상, 행동, 빛, 주변의 자세한 영어 설명을 적습니다. 편집은 원본을 <Picture 1>로 지정하고 이후 참조에 번호를 부여합니다.
전체 구도를 비교하고 검토합니다
화면비, 해상도, 형식을 고르고 고정 seed로 LoRA 적용·미적용을 비교합니다. 스타일, 구도, 불필요한 글자를 확인합니다. seed는 동일 결과를 약속하지 않습니다.
LoRA 가중치로 원본 사진 스타일 변경
사진 등 기존 이미지에서 시작할 때 MiniMax H3-Image Open Weights LoRA를 사용합니다. 편집 원본, 선택 참조, 지시, 가중치 파일 최대 3개를 결합합니다. 1930년대 만화 어댑터처럼 테스트한 표현을 적용하며 장면을 수정할 수 있습니다.
업로드 순서에서 <Picture 1>이 편집 대상입니다. 이후 입력은 인물, 사물, 장소를 제공하는 참조입니다. 지시에서 역할을 정해 변경과 유지 요소를 분명히 합니다. 인물 사진은 사용 권한이 있는 성인만 사용하고 사칭하지 않습니다.
편집 파라미터
| 파라미터 | 허용 값과 역할 |
|---|---|
image_urls | 원본부터 시작해 참조 최대 8장, 총 1~9장 |
prompt | 필수, 최대 5,000자, <Picture N>으로 입력 지정 |
loras | 직접 .safetensors URL을 포함한 {path, scale} 최대 3개 |
loras[].scale | 파일별 0~4, 기본 1 |
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, 기본 1k |
output_format | 기본 jpeg, png나 webp 선택 가능 |
seed | 한 요소 변경 비교용 난수 제어, 선택 사항 |
화면비와 해상도는 목적이 다릅니다. 비율 생략 시 원본을 따르고 단계는 요청 크기와 요금을 정합니다. 오픈웨이트 4k 16:9 실측은 5472 x 3072픽셀이며 단계 이름이 공통 너비를 정하지 않습니다.
원본 역할을 중심으로 지시 작성
어댑터 트리거로 시작해 다시 그릴 요소와 남길 요소를 정합니다. 항구 구상은 Studio1939 style과 <Picture 1>, 흑백 러버호스 만화 항구, 웃는 보트, 둥근 외곽선, 도시 윤곽 배치 유지를 설명할 수 있습니다. 문구만 쓰지 말고 해당 파일을 loras에 제공합니다.
지원 사진 추가
장소 변경에서는 <Picture 1>의 40대 여성을 <Picture 2>의 라운지로 옮겨 따뜻한 램프 옆에 남색 드레스로 배치하고 얼굴을 알아볼 수 있게 유지하도록 설명합니다. 해당 파일을 연결하면 VHS 트리거를 앞에 둘 수 있습니다. 정확히 테스트한 장면이 아닌 제안입니다.
변경과 보존 목표를 구분합니다.
- 인물이나 사물을 제공할 사진을 지정합니다.
- 대체할 옷, 주변, 조명을 설명합니다.
- 알아볼 수 있게 남길 얼굴, 자세, 배치를 정합니다.
- 편집 후 원본과 해당 요소를 대조합니다.
편집 근거
테스트한 H3 영상 모델의 만화 LoRA는 이 이미지 체크포인트에서 작동했습니다. 사진은 자세를 유지하며 1930년대 러버호스 만화가 됐습니다. 항구 예시는 도시 윤곽 배치를 남기며 항구와 보트를 흑백 만화로 바꿨습니다.
별도 H3-Image 테스트에서는 의상·장소 변경에 얼굴이 유지됐고 두 사진 구도에서 대상을 다른 장면에 배치했습니다. 참조 편집을 시도할 근거지만 연결 어댑터가 모든 동일 인물과 배치를 보존함을 입증하지는 않습니다. VHS 적용·미적용 비교도 구도를 바꿨으므로 고정 seed는 동일 결과 보장이 아닌 비교 보조입니다.
파일, 흔적, 문제 해결
Hugging Face /resolve/main/ URL은 .safetensors 가중치 자체로 이어져야 합니다. 각 항목은 별도 scale을 가지며 시작값은 1입니다. 혼합 평가 전 파일 하나를 평가하고 scale 조정 중 프롬프트, 원본 순서, seed를 유지합니다.
깨진 링크 요청은 Failed to load LoRA와 함께 이미지와 과금 없이 끝났습니다. URL이 해당 파일을 다운로드하는지 확인하고 고친 링크로 재시도합니다. 실패 시 표현 없는 출력으로 조용히 대체하지 않습니다. VHS 식당 생성의 모서리에 vh5tape가 나타났으므로 스타일 편집에서도 학습 자료에서 따라온 글자를 확인합니다.
과금과 다른 엔드포인트 선택
완료 편집은 해상도 단계 요금에 고정 LoRA 추가분을 더하며 첫 원본 이후 참조마다 요금이 붙습니다. LoRA 연결이 0개, 1개, 3개여도 추가분은 같고 jpeg 대신 png나 webp를 골라도 같습니다. 모델 페이지에 현재 요금이 있으며 실패 요청은 무료입니다.
어댑터 없이 seed와 5단계를 유지하려면 Open Weights를 사용합니다. 10~16장 입력에는 최대 16장을 받는 MiniMax H3-Image를 고려합니다. 화면비 동작과 3단계 메뉴가 다르고 seed는 없습니다. 원본 없이 글로 시작하려면 이 계열의 text-to-image를 고릅니다. 기존 H3 Image LoRA는 영상 모델로 단일 프레임을 만들므로 별도 평가합니다.
콘텐츠 테스트에도 한계가 있습니다. 거부 없이 이미지가 반환됐지만 표준 테스트의 Very strong 편집은 매번 완화됐습니다. 전달 성공이 모든 지시 준수를 뜻하지는 않습니다.
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-lora/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 레퍼런스에서 확인하세요.

























