소개
FLUX.1 Kontext [pro] 텍스트로 이미지는 Black Forest Labs가 2025년 5월 29일 공개한 두 가지 상용 Kontext 모델 중 더 빠른 쪽입니다. Kontext는 인컨텍스트 모델로 만들어져, 문장으로 그림을 그린 바로 그 네트워크가 나중에 그 그림을 다시 받아 한 가지만 바꿀 수 있습니다. 이 엔드포인트는 그 흐름의 앞부분입니다. 장면을 쓰면 약 100만 화소의 사진이 나오고, 마음에 드는 결과는 의상이나 조명, 간판 문구를 바꾸고 싶을 때 편집 엔드포인트로 그대로 보낼 수 있습니다.
가진 재료로 모드 고르기
| 가진 것 | 모드 |
|---|---|
| 글로 쓴 장면만 | FLUX.1 Kontext [pro] 텍스트로 이미지 |
| 바꾸고 싶은 사진 한 장 | FLUX.1 Kontext [pro] 편집 |
핵심 기능 및 하이라이트
놓은 자리에 들어가는 글자
Kontext [pro]는 따옴표 안의 단어를 그려야 할 글자로 읽습니다. 화장대 테스트에서 거울에 립스틱 메모를 요청하자 ‘Room 412 - Midnight’가 빨간 손글씨로 유리 위에 그려졌고, 모텔 테스트에서는 ‘PALM COURT’가 분홍색 필기체 네온으로 나왔습니다. 둘 다 쓴 그대로의 철자였습니다.
6가지 비율, 모두 약 100만 화소
정사각형, 가로형 두 가지, 세로형 두 가지, 그리고 21:9 초광폭입니다. 어느 비율이든 약 100만 화소로 나오며, 측정 결과 16:9는 1280x720, 3:4는 864x1152, 21:9는 1520x656이었습니다.
나중에 편집하도록 만든 구조
이 엔드포인트의 결과는 편집 엔드포인트로 바로 넘길 수 있습니다. 같은 모델이 얼굴과 포즈를 그대로 두고 옷, 날씨, 글자를 바꾸므로 여기서 그린 장면은 연작의 첫 장면으로 적합합니다.
빠른 응답
21:9와 9:16을 포함해 텍스트로 이미지 실행 대부분이 10~30초 안에 돌아왔습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
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 [pro]가 그리기 전에 프롬프트에 묘사를 보태므로 짧은 프롬프트에 도움이 되지만 조금 더 걸릴 수 있습니다. 기본값: |
요금
$0.028 / 장
Kontext [pro] 텍스트로 이미지는 장당 과금되며 형태, 형식, 프롬프트 확장은 가격을 바꾸지 않습니다. 거절되거나 실패한 요청은 과금되지 않습니다.
활용 사례
인물과 의상 보드
이야기에 맞는 장면에서 인물을 한 번 그린 뒤, 매번 새 얼굴을 다시 뽑는 대신 그 한 장에서 편집으로 의상과 분위기를 나눕니다.
간판, 메모, 소품
호텔 문, 네온사인, 손글씨 메모, 라벨처럼 정해진 자리에 정해진 문구가 필요한 것들입니다.
SNS와 캠페인용 컷
같은 글에서 스토리용 9:16, 헤더용 16:9, 배너용 21:9를 만듭니다.
프롬프트 가이드 및 실전 팁
태그 나열 대신 장면을 묘사하기
누가, 무엇을 입고, 어디에 있으며, 빛은 어디서 오고, 어떤 렌즈 느낌인지 씁니다. Kontext [pro]는 키워드 나열보다 평범한 문장을 더 잘 따릅니다.
들어가야 할 단어는 모두 따옴표로
글자는 따옴표 안에 정확히 쓰고 거울 위, 문 위, 티켓 위처럼 어디에 들어가는지도 적습니다.
짧은 프롬프트에는 확장 기능을
한 줄짜리 프롬프트는 밋밋하게 나올 수 있습니다. 프롬프트 확장을 켜면 모델이 세부를 보태고, 문장 하나하나가 중요할 때는 꺼 둡니다.
편집 단계를 미리 생각하기
나중에 의상을 바꿀 계획이라면 얼굴, 머리, 포즈를 지금 분명하게 적어 둡니다. 편집은 그 부분을 붙잡고 유지합니다.
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/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 레퍼런스에서 확인하세요.


























