소개
FLUX.1 Kontext [max] 편집은 Black Forest Labs가 2025년 5월 29일 공개한 프리미엄 Kontext 모델로, 글로 쓴 지시에 따라 사진 한 장의 스타일을 바꾸거나 수정합니다. 새 시대, 새 시간대, 새 계절처럼 화면 전체에 닿는 편집에서 인물과 글자를 온전히 살려야 할 때 고르는 등급입니다.
재료에 맞는 모드
| 가진 것 | 모드 |
|---|---|
| 스타일을 바꾸거나 고칠 완성 사진 한 장 | FLUX.1 Kontext [max] 편집 |
| 아직 그림 없이 글로 쓴 장면 | FLUX.1 Kontext [max] 텍스트로 이미지 |
핵심 기능 및 하이라이트
출연진을 지키는 전면 스타일 변경
옥상 커플을 강한 키 라이트의 1950년대 흑백 필름 누아르 스틸로 바꿨습니다. 두 얼굴, 포옹, 드레스 실루엣이 이어졌고 벽 간판도 읽을 수 있게 남았습니다(새 구도 때문에 오른쪽이 살짝 잘렸습니다).
시간과 계절 바꾸기
야간열차 침대칸이 설산 위 일출로 바뀌었고, 붉은 로브는 아이보리 실크로, 와인잔은 커피잔이 됐습니다. 여성의 얼굴과 다리를 접은 자세는 그대로였습니다.
지시 하나에 여러 변경
침대칸 편집에서 Kontext [max]는 빛, 옷, 소품 세 가지를 한 번에 처리했고, 각각 나머지를 흐트러뜨리지 않았습니다.
형태는 원본을 따름
auto이면 원래 구도를 유지합니다. 16:9 옥상은 1328x752로, 3:4 침대칸은 864x1152로 나왔습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수, 최대 5,000자입니다. 새 룩이나 변경을 먼저, 그다음 고정할 것(얼굴, 포즈, 옷의 형태, 남길 글자)을 쓰세요. 1자 이상 · 5000자 이하 |
image_url | 예 | 필수입니다. Kontext [max]가 편집할 사진 한 장으로, 최대 10MB의 JPEG, PNG, WebP입니다. 1자 이상 |
aspect_ratio | 아니요 | auto(기본)는 원본 사진을 따릅니다. 1:1, 16:9, 9:16, 4:3, 3:4, 21:9를 고르면 구도를 바꿉니다. |
output_format | 아니요 | jpeg(기본) 또는 png이며 가격 차이는 없습니다. |
enable_prompt_expansion | 아니요 | 기본값은 꺼짐입니다. 켜면 Kontext [max]가 편집하기 전에 지시에 묘사를 더합니다. 기본값: |
요금
$0.056 / 장
Kontext [max] 편집은 매번 텍스트로 이미지와 같은 정액 장당 요금입니다. 거절되거나 실패한 요청에는 요금이 붙지 않습니다.
활용 사례
시대와 장르 룩
필름 누아르, 1970년대 컬러 필름, 광택 있는 잡지 화보처럼 사진 한 장을 캠페인이나 무드보드용으로 다른 시대에 다시 찍습니다.
하루에 걸친 연속성
같은 인물이 있는 같은 장면의 아침, 노을, 밤 버전입니다.
완성 컷의 의상과 소품 교체
이미 마음에 드는 이미지의 로브, 잔, 가방, 모자를 바꿉니다.
아쉬운 컷 살리기
거의 좋은 컷에서 어긋난 한 가지만 고쳐, 다시 생성하지 않아도 됩니다.
프롬프트 가이드 및 실전 팁
룩을 말한 뒤 고정할 것을
‘1950년대 흑백 필름 누아르 스틸로 바꿔 줘’라고 쓰고, 이어서 ‘두 사람의 얼굴, 포즈, 간판은 그대로 둬’라고 씁니다.
관련된 변경은 묶기
일출과 아이보리 로브와 커피처럼 하나의 새 순간을 그린다면 빛, 옷, 소품을 지시 하나로 묶을 수 있습니다.
남길 글자는 이름으로
간판이나 라벨을 그 문구로 부르면 편집이 그것을 지켜야 할 대상으로 다룹니다.
자르기는 의도적으로
새 프레임이 필요할 때만 비율을 고르고, 그 밖에는 auto로 뜻밖의 크롭을 피합니다.
큰 스타일 변경 뒤에는 얼굴 비교하기
시대와 조명 변경은 인물 동일성에 가장 어려운 시험입니다. 결과와 원본을 나란히 놓고 비교하고, 얼굴이 달라졌다면 지킬 목록의 맨 앞에 얼굴을 적어 다시 바꾸세요.
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-kontext-max/edit",
"input": {
"aspect_ratio": "auto",
"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 레퍼런스에서 확인하세요.


























