소개
FLUX.2 [klein] 9B 편집은 2026년 1월 15일 공개된 Black Forest Labs의 작고 빠른 이미지 모델의 편집 모드입니다. 원본 이미지 1~3장과 지시문을 받아 약 100만 화소 또는 선택한 1k·2k 단계의 JPEG를 돌려주며, 콘텐츠 필터는 없습니다.
출발 자료에 따라 모드 고르기
| 가진 것 | 모드 |
|---|---|
| 글로 쓴 브리프 | FLUX.2 Klein 9B 텍스트→이미지 |
| 바꿀 이미지 | FLUX.2 Klein 9B 편집 |
핵심 기능 및 하이라이트
같은 인물, 새로운 룩
저희 테스트에서 의상과 배경을 바꿔도 얼굴, 머리, 자세가 유지되었습니다. 그대로 둘 것을 먼저 나열한 뒤 변경 내용을 설명하세요.
편집하면서 크기 조정
비율과 크기 단계를 고르면 긴 변 2048픽셀로 편집 결과가 돌아옵니다. auto에서는 원본 비율을 유지합니다.
균일한 가격
편집 요금은 원본이 한 장이든 세 장이든, 1k든 2k든 같습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수, 최대 5,000자. 무엇을 바꾸고 무엇을 그대로 둘지(예: 얼굴, 머리, 자세) 적고, 새 옷이 있다면 이름을 적으세요. 1자 이상 · 5000자 이하 |
image_urls | 예 | 필수이며 장당 최대 10 MB의 원본 이미지 1~3장입니다. 프롬프트가 가리키는 순서대로 넣으세요. 1개 이상 · 3개 이하 |
aspect_ratio | 아니요 | auto(기본값)는 첫 번째 원본 이미지의 비율을 약 100만 화소로 유지하며, 또는 21:9부터 9:21까지 9가지 비율 중 하나를 고를 수 있습니다. 비율은 가격에 영향을 주지 않습니다. |
resolution | 아니요 | 1k(기본값) 또는 2k이며, 화면비를 골랐을 때만 적용됩니다. auto에서는 결과가 약 100만 화소로 유지됩니다. |
seed | 아니요 | 선택 사항이며 0부터 2,147,483,647까지의 정수입니다. 프롬프트 변경을 나란히 비교하려면 같은 값을 다시 쓰고, 비워 두면 무작위 값이 쓰입니다. |
요금
$0.016 / 장
원본 이미지 수나 1k·2k 여부와 관계없이 이미지당 균일가입니다. 실패하거나 거부된 요청에는 요금이 부과되지 않습니다.
활용 사례
의상과 장면 교체
사람은 알아볼 수 있게 두고 옷, 공간, 시간대를 바꿉니다.
사진의 빠른 변형
커피 한 잔 마실 시간에 한 장의 사진으로 여러 분위기를 만듭니다.
최대 3장의 원본 결합
인물, 장소, 사물을 하나의 프레임에 모으고, 프롬프트에서 각각을 지정합니다.
프롬프트 가이드 및 실전 팁
유지할 것을 먼저 말하기
얼굴, 머리, 자세, 앉은 자리를 적은 다음 변경 내용을 한두 문장으로 설명하세요.
새 옷의 이름 붙이기
원하는 재단과 소재를 적으세요. 저희 테스트에서 편집은 프롬프트에 적은 옷을 따랐습니다.
한 번에 하나씩 바꾸기
큰 변화는 편집을 두 번 이어서 하세요.
2k는 비율을 골라서
auto는 약 100만 화소입니다. 2k 단계를 원하면 비율을 고르세요.
손과 얼굴 확인하기
작은 모델은 둘 다 틀어질 수 있습니다. 어긋나면 다른 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-9b/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 레퍼런스에서 확인하세요.
























