소개
원본 이미지 한 장을 보내고 원하는 결과를 적습니다. 강도는 출력이 원본에서 얼마나 멀어질지 정하며, 흑백 마스크를 더하면 흰 부분만 다시 그리고 나머지는 그대로 둡니다. FLUX.1 [dev]용으로 학습한 LoRA 파일을 최대 3개 불러올 수 있고, 가격은 이미지당 균일하며, 필터링되지 않습니다.
| 항목 | 값 |
|---|---|
| 입력 | 이미지 |
| 출력 | 이미지 |
| 엔드포인트 | 텍스트→이미지와 이미지 편집(강도, 선택형 인페인팅 마스크), 둘 다 LoRA 지원 |
| 기본 모델 | FLUX.1 [dev], Black Forest Labs의 120억 파라미터 rectified flow 트랜스포머 |
| LoRA 입력 | 최대 3개 항목, 각각 {path, scale}. path는 .safetensors 파일로 가는 직접 HTTPS URL |
| LoRA 강도 | 항목별 0~4 (기본값 1) |
| 가이던스 | 0~20 (기본값 3.5) |
| 출력 크기 | 약 100만 화소: 1:1은 1024 x 1024, 16:9는 1344 x 768, 21:9는 1536 x 640 |
| 화면비 | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21 |
| 출력 형식 | JPEG (기본값), PNG, WebP |
핵심 기능 및 하이라이트
렌더가 아니라 사진
Super Realism LoRA와 비 오는 창가의 늦은 밤 부스 자리, 따뜻한 펜던트 조명 아래 서로에게 기울어진 두 남성. 피부, 원단, 창빛이 사진처럼 읽힙니다.
트리거 하나로 매거진 룩
"MJ v6"와 Midjourney 스타일 LoRA가 FLUX에 윤기 나는 에디토리얼 마감을 입힙니다. 대리석 계단 위에서 옆빛을 받은 백리스 레드 새틴 가운이 그 결과입니다.
매체를 통째로 바꾸기
팔다리가 긴 카툰 LoRA를 1.2로 쓰면 같은 모델이 핀업 일러스트레이터가 됩니다. 빨간 우산, 젖은 자갈길, 과장된 비율까지 담깁니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 돌려받고 싶은 이미지 전체를 묘사하십시오. 마스크를 쓸 때는 흰 부분에 나타날 내용을 적습니다. 1자 이상 · 5000자 이하 |
image_url | 예 | 편집할 그림입니다. 결과는 모양을 유지한 채 약 70만 화소로 나옵니다. |
mask_url | 아니요 | 선택 항목입니다. 원본과 같은 크기의 흑백 이미지로, 흰 부분은 프롬프트대로 다시 그리고 검은 부분은 그대로 둡니다. |
strength | 아니요 | 원본에서 얼마나 멀어질지이며 0 |
loras | 아니요 | FLUX.1 [dev]용으로 학습한 {path, scale} 항목을 최대 3개까지 넣습니다. scale은 0~4이고 1이 기준입니다. 기본값: |
guidance_scale | 아니요 | 결과가 프롬프트를 얼마나 따를지이며 0~20(기본값 3.5)입니다. 실사 계열 LoRA는 조금 낮출 때 더 자연스러운 경우가 많습니다. |
steps | 아니요 | 노이즈 제거 단계 수이며 1~50(기본값 28)입니다. 단계가 많을수록 생성 시간이 길어집니다. |
output_format | 아니요 | 기본값은 JPEG이며 필요하면 PNG나 WebP를 고를 수 있습니다. 가격은 바뀌지 않습니다. |
seed | 아니요 | 강도나 마스크를 조정하는 동안 결과를 비교하기 쉽게 해 줍니다. 같은 seed라도 똑같은 이미지가 나온다는 보장은 없습니다. |
요금
$0.018 / 장
이미지당 균일한 가격으로 청구됩니다. 마스크, 강도, 단계 수, LoRA에는 별도 요금이 붙지 않습니다.
활용 사례
이미 찾아 둔 그 LoRA
원하는 룩이 Hugging Face나 커뮤니티 허브에 FLUX LoRA로 올라와 있다면, 여기서 평범한 API 호출로 돌릴 수 있습니다. 파일 링크를 붙여 넣고, scale을 정하고, 프롬프트를 쓰면 됩니다.
패션과 에디토리얼 스틸
리얼리즘 LoRA와 매거진 스타일 LoRA로 대리석 계단 위의 백리스 가운도, 비 오는 창가의 늦은 밤 부스 자리도 믿을 만한 빛과 피부 질감으로 표현합니다.
스타일을 맞춘 캠페인
카툰, 핀업, 일러스트 LoRA로 프롬프트 템플릿 하나를 9가지 화면비에 걸친 일관된 시리즈로 만듭니다.
무검열 스틸
검열 없는 LoRA가 심사 없이 불러와지고 출력은 필터링되지 않으며, 그런 자유를 기대하는 사용자가 있는 플랫폼에 맞는 선택입니다.
프롬프트 가이드 및 실전 팁
LoRA의 트리거를 찾으십시오
FLUX LoRA 대부분은 모델 카드에 "Super Realism"이나 "MJ v6" 같은 트리거 문구를 적어 둡니다. 그 문구를 프롬프트 맨 앞에 넣고 그다음 그림을 묘사하십시오.
리얼리즘 LoRA에서는 가이던스를 조정하십시오
가이던스 기본값은 3.5입니다. 리얼리즘 LoRA는 2에서 3.5 사이에서 더 자연스러워 보이는 경우가 많고, 값을 너무 높이면 번들거리고 과하게 샤프한 룩으로 기웁니다.
강한 스타일은 scale을 올리십시오
일부 스타일 LoRA는 scale이 1을 넘어야 주도권을 잡습니다. 저희 카툰 예시는 1.2로 돌렸습니다. 1에서 시작해 0.2씩 움직이십시오.
파일이 공개되어 있는지 확인하십시오
.safetensors 파일을 바로 내려받는 직접 링크를 쓰십시오. 접근이 제한된 저장소는 HTTP 401로 응답하며, 이미지가 만들어지기 전에 요청이 실패합니다.
소개
FLUX.1 Dev LoRA 이미지 편집은 Black Forest Labs의 FLUX.1 [dev]로 원본 이미지 한 장을 바꿉니다. 프롬프트와 직접 준비한 LoRA 파일 최대 3개가 방향을 정합니다. 마스크 없이는 화면 전체의 스타일을 바꾸고, 0~1의 강도 값이 원본에서 얼마나 멀어질지 정합니다. 흑백 마스크를 쓰면 흰 부분만 다시 그리고 나머지는 그대로 둡니다. 결과는 JPEG, PNG, WebP 중 하나로 균일한 가격에 나오며 필터링되지 않습니다.
가진 재료로 모드 고르기
| 가진 것 | 모드 |
|---|---|
| 전체나 일부를 바꿀 그림 | FLUX.1 Dev LoRA 이미지 편집 |
| 글로 된 설명뿐 | FLUX.1 Dev LoRA 텍스트→이미지 |
주요 기능과 특징
마스크 인페인팅
바꿀 부분은 흰색, 나머지는 검은색으로 칠합니다. 저희 테스트에서 스튜디오 인물 사진의 상체에 마스크를 씌우자 그 부분만 바뀌고 얼굴, 머리카락, 바지는 그대로 남았습니다.
이해하기 쉬운 강도
기본값 0.8은 포즈와 구도를 유지하고, 0.95는 얼굴을 포함해 거의 모든 것을 다시 그립니다. 마스크를 쓸 때는 0.9~1로 두어야 흰 부분이 확실히 바뀝니다.
무검열, 직접 고른 가중치
원본, 프롬프트, 가중치, 결과 어느 것도 필터링되지 않습니다. 강도 0.95에서 스튜디오 인물 사진이 저희 최강 테스트의 요청대로 편집되었으며, 검열 없는 LoRA가 있을 때와 없을 때 모두 그러했습니다.
활용 사례
사진의 일부만 바꾸기
의상, 배경, 소품을 바꾸고 나머지는 그대로 둘 수 있어 제품 베리에이션, 의상 테스트, 인물 사진 보정에 알맞습니다.
커뮤니티 LoRA로 스타일 바꾸기
천 개가 넘는 FLUX LoRA 가운데 하나에 사진을 통과시키면 구도는 그대로 두고 필름 질감, 에디토리얼 광택, 일러스트 느낌으로 바꿀 수 있습니다.
프롬프트 가이드와 팁
지시가 아니라 결과를 적기
완성된 이미지에 무엇이 담겨야 하는지 적으십시오. 마스크를 쓸 때는 흰 부분에 들어갈 내용만 ‘검은 벨벳 상의, 부드러운 스튜디오 조명’처럼 적습니다.
마스크의 딱딱한 가장자리 부드럽게 하기
딱딱한 직사각형 마스크는 남긴 부분과 만나는 곳에 이음매가 보입니다. 마스크 가장자리를 흐리게 하거나 바꿀 물체의 윤곽을 따라 칠하십시오.
0.8에서 시작해 0.05씩 움직이기
원본이 너무 비치면 강도를 올리고, 얼굴이 달라지면 낮추십시오. 비교하는 동안에는 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": "black-forest-labs/flux-1-dev-lora/edit",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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 레퍼런스에서 확인하세요.



























