소개
FLUX.1 Kontext [pro] 편집은 사진 한 장과 글로 쓴 지시를 받아, 그 지시를 반영한 같은 사진을 돌려줍니다. Black Forest Labs는 2025년 5월 29일 맥락 안에서 편집하는 모델로 Kontext를 공개했습니다. 장면을 처음부터 다시 그리지 않고 보낸 사진을 읽기 때문에, 텍스트로 이미지 모델이라면 새로 그려야 할 편집에서도 얼굴, 포즈, 방, 글자가 남습니다.
가진 재료로 모드 고르기
| 가진 것 | 모드 |
|---|---|
| 바꾸고 싶은 사진 한 장 | FLUX.1 Kontext [pro] 편집 |
| 글로 쓴 장면만 | FLUX.1 Kontext [pro] 텍스트로 이미지 |
핵심 기능 및 하이라이트
부분만 바꾸고 나머지는 그대로
화장대 테스트에서 샴페인색 새틴 슬립을 검은 레이스로 바꿨습니다. 얼굴, 머리, 전구 조명, 거울의 립스틱 글자는 제자리에 있었습니다.
같은 컷에서 날씨, 시간, 빛 바꾸기
모텔 수영장을 해 질 녘에서 비 오는 밤으로 바꿨습니다. 물 위의 빗방울, 젖은 타일에 비친 네온, 흠뻑 젖은 셔츠가 생겼고 남자의 얼굴과 포즈는 그대로였습니다.
간판과 글자는 편집 후에도 유지
사진에 이미 있는 글자는 바꾸라고 하지 않는 한 그대로 남고, 새 글자는 따옴표로 쓰면 추가됩니다.
원래 비율 유지 또는 새 비율 지정
화면비를 auto로 두면 결과가 원본을 따릅니다. 1344x768 사진은 1328x752로, 정사각형은 992x992로 나왔습니다. 비율을 고르면 잘라내거나 확장합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수, 최대 5,000자입니다. 먼저 변경을 쓰고 이어서 유지할 것(얼굴, 머리, 포즈, 배경, 기존 글자)을 적으세요. 1자 이상 · 5000자 이하 |
image_url | 예 | 필수입니다. 최대 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 | 아니요 | 기본값은 꺼짐입니다. 켜면 편집 전에 지시에 세부가 더해집니다. 기본값: |
요금
$0.028 / 장
Kontext [pro] 편집은 원본의 크기나 형태와 관계없이 텍스트로 이미지와 같은 장당 요금입니다. 거절되거나 실패한 요청은 과금되지 않습니다.
활용 사례
의상과 스타일링 교체
한 장의 인물 사진에서 새틴, 레이스, 블레이저, 로브 등 여러 룩을 같은 원본의 개별 편집으로 만듭니다.
분위기와 조명 변형
낮에서 밤으로, 맑음에서 비로, 따뜻한 톤에서 차가운 톤으로 바꿔도 인물은 잃지 않습니다.
연작의 연속성
각 결과를 다음 원본으로 넣어, 작고 통제된 변화를 이어 가며 인물을 장면에서 장면으로 옮깁니다.
세부 수정
간판 문구 바꾸기, 물건 지우기, 옷 색 바꾸기 같은 작업입니다.
프롬프트 가이드 및 실전 팁
먼저 변경, 그다음 고정할 것
‘슬립을 검은 레이스로 바꿔 줘’를 먼저 쓰고, 이어서 ‘얼굴, 머리, 포즈, 거울 글자는 정확히 그대로 둬’라고 씁니다.
생김새로 부르기
‘그녀의 옷’ 대신 ‘샴페인색 새틴 슬립’이라고 씁니다. 모델은 설명으로 영역을 찾습니다.
한 번에 한 가지 변경
긴 지시 하나로 모든 것을 바꾸기보다 작은 편집을 이어 가는 편이 인물을 더 잘 유지합니다.
원본 형태에는 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-pro/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 레퍼런스에서 확인하세요.


























