소개
FLUX.2 [klein] 4B 이미지 편집은 Apache 2.0 오픈소스로 공개된 Black Forest Labs의 가장 작은 FLUX.2 모델로 지시문에 따라 최대 3장의 원본 이미지를 바꾸거나 합칩니다. auto로 첫 이미지의 비율을 유지하거나, 비율과 1k·2k 크기 단계를 고를 수 있습니다. 편집은 이미지당 균일가이며 콘텐츠 필터는 적용되지 않습니다.
출발 자료에 따라 모드 고르기
| 가진 것 | 모드 |
|---|---|
| 글로 쓴 설명 | FLUX.2 Klein 4B 텍스트→이미지 |
| 바꾸거나 합칠 사진 1~3장 | FLUX.2 Klein 4B 이미지 편집 |
핵심 기능 및 하이라이트
최대 3장의 참조 이미지
두 장의 초상과 한 장소를 합치거나 사진 한 장의 스타일을 바꿀 수 있습니다. 원본 수가 달라져도 가격은 같습니다.
인물을 지키는 편집
새 배경, 빛, 날씨를 요청하면서 얼굴, 옷, 자세는 유지하세요. 원본 한 장일 때는 깔끔하게 되고, 세 장일 때는 얼굴이 조금 달라질 수 있습니다.
오픈이며 필터는 없습니다
어떤 것도 검토되거나 거절되지 않습니다. 저희 테스트에서 편집은 필터 없는 원본을 그대로 유지했으며, 매우 강함 단계만 수위가 낮춰져 돌아왔습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 무엇을 바꾸고 무엇을 그대로 둘지 최대 5,000자까지 적으세요. 원본이 여러 장이면 image 1, image 2, image 3으로 가리키세요. 1자 이상 · 5000자 이하 |
image_urls | 예 | 장당 최대 10 MB의 원본 이미지 1~3장이며, 프롬프트가 가리키는 순서대로 넣으세요. 필수입니다. 1개 이상 · 3개 이하 |
aspect_ratio | 아니요 | Auto(기본값)는 첫 번째 원본의 비율을 약 100만 화소로 유지합니다. 또는 21:9부터 9:21까지 9가지 비율 중 하나를 고르세요. |
resolution | 아니요 | 1k(기본값) 또는 2k이며 2k는 긴 변 2048픽셀입니다. 비율을 골랐을 때만 적용되고, auto에서는 약 100만 화소입니다. |
seed | 아니요 | 0부터 2147483647까지의 숫자입니다. 프롬프트의 한 가지 디테일만 바꾸며 편집 결과를 비교하려면 같은 값을 다시 쓰세요. |
요금
$0.013 / 장
원본 이미지 수나 크기 단계와 관계없이 이미지당 균일가로 과금합니다. 실패한 요청에는 요금이 부과되지 않습니다.
활용 사례
배경과 분위기 교체
한 번에 햇살 비치는 거리의 커플을 비 오는 네온의 밤으로 옮깁니다.
인물을 장소로 데려오기
스토리보드, 표지, 캐릭터 시트를 위해 두 장의 초상을 장소 사진 안에 놓습니다.
빠른 스타일 변경
구도는 그대로 두고 빛, 계절, 팔레트를 바꿉니다.
프롬프트 가이드 및 실전 팁
지킬 것을 먼저, 바꿀 것은 그다음
그대로 남아야 할 것으로 시작한 뒤 변경 내용만 설명하세요. 짧고 구체적인 지시가 가장 잘 작동합니다.
원본마다 역할 주기
이미지가 여러 장이면 각각이 무엇을 맡는지 말하세요. 이 사람, 저 사람, 이 장소처럼요.
디테일 확인하기
원본이 두세 장일 때는 손, 머리, 액세서리를 확인하세요. 작은 물건이 하나 더 생길 수 있습니다. 어긋나면 다른 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-2-klein-4b/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"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 레퍼런스에서 확인하세요.

























