소개
FLUX.1 Kontext [max] 텍스트로 이미지는 Black Forest Labs가 2025년 5월 29일 발표한 Kontext 제품군의 프리미엄 등급으로, 개발사는 프롬프트 충실도와 타이포그래피를 최대로 끌어올린 모델로 소개합니다. 빠른 등급이 신속한 반복에 맞춰져 있다면, Kontext [max]는 추가 비용을 여러 인물과 겹겹의 소품, 긴 글자가 들어간 장면에 씁니다. 글로 쓴 브리프에 약 100만 화소 사진으로 답하고, 그 사진은 Kontext [max] 편집 엔드포인트로 바로 넘길 수 있습니다.
재료에 맞는 모드
| 가진 것 | 모드 |
|---|---|
| 복잡해도 괜찮은 글로 쓴 장면 | FLUX.1 Kontext [max] 텍스트로 이미지 |
| 스타일을 바꾸거나 고칠 완성 사진 한 장 | FLUX.1 Kontext [max] 편집 |
핵심 기능 및 하이라이트
두 사람, 하나의 자연스러운 순간
옥상 브리프에서 등이 파인 에메랄드 드레스의 여성을 난간에, 그녀의 허리에 손을 얹고 바로 뒤에 선 남성을 배치했습니다. Kontext [max]는 두 얼굴을 또렷이 구분하고, 손을 프롬프트대로 두었으며, 아래 도시 불빛을 자연스럽게 흐렸습니다.
세월이 묻은 글자
같은 장면에 바랜 금색의 ‘HOTEL CASSIOPEIA’ 손그림 벽 간판을 요청했습니다. 철자는 정확했고, 깔끔한 디지털 서체가 아니라 벗겨진 페인트와 낡은 판자로 그려졌습니다.
이야기를 전하는 작은 소품
야간열차 침대칸 프롬프트에서 붉은 실크 로브, 와인잔, 빗줄기가 흐르는 창, 테이블 위 승차권을 나열했고 모두 설명한 자리에 나왔습니다.
여섯 가지 형태, 약 100만 화소
측정 결과 16:9는 1280x720, 3:4는 864x1152였습니다. 21:9, 4:3, 1:1, 9:16도 같은 가격으로 쓸 수 있습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수, 최대 5,000자입니다. 동사와 위치로 장면을 연출하고 소품을 나열하며, 글자는 재료와 함께 따옴표로 쓰세요. 1자 이상 · 5000자 이하 |
aspect_ratio | 아니요 | 1:1(기본), 16:9, 9:16, 4:3, 3:4, 21:9입니다. 모든 형태가 약 100만 화소이며 가격이 같습니다. |
output_format | 아니요 | jpeg(기본)는 파일을 작게 유지하고 png는 무손실입니다. 가격은 그대로입니다. |
enable_prompt_expansion | 아니요 | 기본값은 꺼짐입니다. 켜면 Kontext [max]가 그리기 전에 짧은 프롬프트를 보강합니다. 기본값: |
요금
$0.056 / 장
Kontext [max] 텍스트로 이미지는 형태나 형식과 무관하게 이미지당 정액입니다. 거절되거나 실패한 요청에는 요금이 붙지 않습니다.
활용 사례
장면 속에 문구가 있는 캠페인 사진
간판, 승차권, 라벨이 위에 얹은 캡션이 아니라 사진의 일부인 호텔, 여행, 패션 컷입니다.
커플과 다인 장면
옷차림과 위치가 뚜렷이 다른 두 사람 이상. 로맨스 표지, 룩북, 스토리보드에 맞습니다.
디테일한 실내
소품이 언제 어디인지를 알려 주는 침대칸, 분장실, 스위트룸입니다.
프롬프트 가이드 및 실전 팁
인물은 동사로 배치하기
‘난간에 기대어 돌아본다’, ‘그녀 바로 뒤에 선다’, ‘한 손을 허리에 얹는다’라고 쓰면 Kontext [max]가 따를 동선이 생깁니다.
글자에 재료를 주기
바랜 금색 페인트, 네온관, 종이 승차권. 재료가 빛 속에서 글자가 어떻게 보일지 정합니다.
카메라의 시대를 밝히기
‘35mm 필름 그레인’이나 ‘영화 스틸’은 아름다운, 멋진 같은 형용사보다 색과 질감을 확실하게 이끕니다.
연출한 장면에서는 확장을 끄기
프롬프트 확장은 소품을 지어낼 수 있습니다. 화면에 들어갈 것을 이미 모두 적었다면 꺼 두세요.
세트를 늘리기 전에 글자 확인하기
한 장을 그린 뒤 간판이나 승차권을 확대해 한 글자씩 읽으세요. 어긋난 단어가 있으면 인용을 줄이거나 장면 속 더 넓은 면으로 옮기고, 그 문구를 나머지 시리즈에서도 그대로 쓰세요.
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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
}'
# 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 레퍼런스에서 확인하세요.


























