# FLUX 3
> Models: FLUX 3 Image Klein · FLUX 3 Image Klein Base
>
> Developer: Black Forest Labs
>
> License: FLUX Kommunity License — **연 매출 500만 달러 미만의 개인·기업은 상업적 이용 무료**
## 개요
FLUX는 Black Forest Labs의 이미지 생성 모델 시리즈입니다. FLUX 3 Image Klein은 상위 모델 FLUX 3 Image의 기능을 유지하면서 **일반 PC의 GPU에서도 돌아가도록 작게 만든 오픈 웨이트 모델**로, 2026년 10월 15일 공개되었습니다. 문장으로 설명하면 그림을 그리고, 참조 이미지를 넣어 편집하며, 영역(바운딩 박스)을 지정해 요소의 위치를 정할 수 있습니다.
두 가지로 나뉩니다.
* **FLUX 3 Image Klein** — 적은 단계(4~16 steps)로 빠르게 생성하도록 증류(distilled)한 모델입니다. 바로 쓰기에 권장됩니다.
* **FLUX 3 Image Klein Base** — 증류하지 않은 기본 모델로, LoRA 등 파인튜닝의 출발점입니다. 생성에 더 많은 단계(약 50 steps)가 필요합니다.
이미지 모델은 파일 하나가 아니라 **이미지 생성 모델(확산 모델) + 텍스트 인코더 + VAE** 여러 파일이 함께 동작합니다. 텍스트 인코더는 Qwen3-VL 4B, VAE는 FLUX.2와 같은 VAE를 씁니다.
**FLUX 3 Image Klein은 프롬프트 업샘플러와 함께 쓰도록 만들어졌습니다.** 제작사는 짧은 요청을 그대로 넣으면 평범한 결과가 나온다고 밝히고, 짧은 요청을 자세한 영어 설명문으로 바꿔 주는 전용 LLM(**FLUX 3 Prompt Upsampler**, Qwen3.5 9B 기반)을 함께 공개했습니다. FlameAI에서도 이 업샘플러를 앞에 두는 2단계 사용을 권장합니다(아래 "FlameAI에서 사용하기").
## 주요 특징
* 텍스트로 이미지 생성, 참조 이미지 편집, 바운딩 박스 레이아웃을 한 모델이 처리
* 생성 모델 5.6B로 가벼움 — 제작사 기준 VRAM 8 GB GPU에서도 실행
* 제작사 발표 기준 최대 4K 해상도 생성
* 참조 이미지 최대 10장 — 여러 대상을 합성하고 정체성을 유지
* 이미지 안 글자 표현 지원(영문, 일문 혼용 예시 공개)
* 전용 프롬프트 업샘플러로 짧은 요청도 자세한 프롬프트로 확장
* FlameBox에서 다른 LLM Cortex와 같은 PC에서 함께 실행 가능
## 모델 사양
|항목|FLUX 3 Image Klein|FLUX 3 Image Klein Base|
|-|-|-|
|공개|2026년 10월 15일|2026년 10월 15일|
|용도|빠른 생성 (step-distilled)|파인튜닝용 기본 모델|
|이미지 생성 모델|5.6B|5.6B|
|텍스트 인코더|Qwen3-VL 4B|Qwen3-VL 4B|
|VAE|FLUX.2 VAE|FLUX.2 VAE|
|권장 steps|4 ~ 16 (기본 16)|약 50|
|CFG|1 고정|3.5 (텍스트→이미지), 편집 1|
|최대 해상도|4K (제작사 발표)|4K (제작사 발표)|
|참조 이미지|최대 10장|최대 10장|
|프롬프트 업샘플러|권장 (FLUX 3 Prompt Upsampler)|권장|
|License|FLUX Kommunity License|FLUX Kommunity License|
> 상위 모델 FLUX 3 Image는 제작사 API로만 제공되며 가중치가 공개되지 않았습니다. 권장 steps·CFG는 제작사의 ComfyUI 공식 템플릿 기준입니다.
## 권장 파라미터
이미지 모델은 LLM과 설정 항목이 다릅니다. `temperature`, `n_ctx` 같은 LLM 설정은 쓰지 않습니다.
### 생성 요청 시 (`imageGenerate`)
```text
width = 1024 # 32의 배수
height = 1024 # 32의 배수
steps = 16 # Klein(증류) 권장: 4~16
cfg_scale = 1.0 # Klein(증류)은 1 고정
sampler = euler
seed = -1 # -1 = 무작위
```
* 위 값은 FlameBox의 FLUX 3 Image Klein 기본값으로, 제작사 권장값과 같습니다(생략하면 자동 적용). 증류 모델은 CFG를 올려도 품질이 좋아지지 않으니 `cfg_scale`은 1.0으로 두세요. 빠른 미리보기가 필요하면 `steps`를 4~8로 낮출 수 있습니다.
* 프롬프트는 **영어로, 구도·조명·색감·스타일까지 자세하게** 쓸수록 좋습니다. 가장 쉬운 방법은 프롬프트 업샘플러가 만든 문장을 그대로 넣는 것입니다.
* 먼저 1024 × 1024로 결과를 확인한 뒤 해상도를 올리세요. 해상도를 올릴수록 생성 시간과 메모리가 크게 늘어납니다.
### Cortex 생성 시
* `offload_to_cpu`(기본 켜짐) — 모델 가중치를 시스템 RAM에 두고 필요한 단계만 GPU로 옮겨 실행합니다.
* `max_vram` — 이 Cortex가 쓸 VRAM 상한(GB). 같은 PC에서 LLM Cortex(프롬프트 업샘플러 등)와 GPU를 나눠 쓸 때 지정합니다.
* `limits` — 요청 가능한 최대 해상도·steps·장수.
## 최소 실행 조건
이미지 모델은 **이미지 생성 모델(확산 모델) + 텍스트 인코더 + VAE** 파일을 모두 내려받아야 하며, 아래 "전체 파일"이 실제 다운로드 크기입니다. FlameBox는 기본적으로 가중치를 시스템 RAM에 두고 단계별로 GPU로 옮겨 실행하므로(`offload_to_cpu`), LLM과 달리 **GPU VRAM과 시스템 RAM이 둘 다 필요합니다.**
### FLUX 3 Image Klein / Klein Base
|구분|원본 (BF16)|Q8|Q5|Q4|Q2|
|-|-|-|-|-|-|
|확산 모델 파일|11.1 GB|6.1 GB|4.5 GB|3.9 GB|2.6 GB|
|전체 파일|13.8 GB|8.8 GB|7.2 GB|6.7 GB|5.3 GB|
|GPU VRAM (1024×1024)|14 GB 이상|8 GB 이상|6 GB 이상|6 GB 이상|4 GB 이상|
|시스템 RAM|16 GB 이상|10 GB 이상|8 GB 이상|7 GB 이상|6 GB 이상|
> * **전체 파일** = 확산 모델 + 텍스트 인코더(Qwen3-VL 4B Q4_0, 2.4 GB) + VAE(FLUX.2 VAE, 0.34 GB). 양자화 칸은 확산 모델 기준 — Q8 = Q8_0, Q5 = Q5_K_XL, Q4 = Q4_K_XL, Q2 = Q2_K_XL. Base는 Klein과 크기가 같습니다.
> * **GPU VRAM**: 한 번에 GPU에 올라가는 가장 큰 단계(확산 모델) 기준 추정치입니다. 제작사는 INT8 빌드로 VRAM 8 GB GPU에서 실행된다고 밝혔고, 위 Q8 값은 이와 맞습니다. **FlameAI에서는 아직 실측하지 않았으며**, VAE 디코드 단계의 메모리는 해상도가 높을수록 커집니다.
> * **시스템 RAM**: 모든 가중치를 RAM에 올려 두는 양(전체 파일 + 약 5%)이며, 운영체제와 다른 프로그램이 쓰는 메모리는 별도입니다.
> * 프롬프트 업샘플러(9B LLM)를 같은 PC에서 함께 돌린다면 그 메모리(Q4 약 6 GB, Q8 약 10 GB)가 더 필요합니다.
> * GPU 없이 CPU만으로도 실행은 가능하지만 매우 느려 권장하지 않습니다.
**PC 기준 예시**
* Klein Q8 — 8 GB 이상 GPU (예: RTX 4060, RTX 3060 12GB) + RAM 16 GB PC
* Klein Q8 + 프롬프트 업샘플러 Q4를 한 PC에서 — 12 ~ 16 GB GPU (예: RTX 4070, RTX 4080) + RAM 32 GB PC
* Klein 원본(BF16) — 16 GB 이상 GPU (예: RTX 4060 Ti 16GB, RTX 4080) + RAM 32 GB PC
OS는 Windows / Linux를 지원합니다(이미지 생성 엔진 기준, macOS는 아직 검증하지 않음).
## FlameAI에서 사용하기
FLUX 3 Image Klein은 **프롬프트 업샘플러 → 이미지 생성**의 2단계로 쓰는 것을 권장합니다. 한 번 더 호출해야 하지만, 그래야 결과가 훨씬 좋습니다.
1. **FlameBox 설치 및 등록** — FlameBox(1.0.10 이상)를 설치하고 내 계정에 등록합니다.
2. **모델 다운로드** — My AI Console의 FlameBox 상세 화면에서 PC 메모리에 맞는 양자화된 모델을 내려받습니다. 텍스트 인코더와 VAE 파일도 함께 내려받습니다. 프롬프트 업샘플러(FLUX 3 Prompt Upsampler)도 같이 내려받습니다.
3. **AI API 두 개 만들기** — FLUX 3 Image Klein으로 이미지 생성 AI API를, 프롬프트 업샘플러로 LLM AI API를 만듭니다.
4. **프롬프트 만들기** — 업샘플러의 `messages` API에 제작사 시스템 프롬프트(텍스트→이미지용 `t2i`)와 짧은 요청을 보냅니다. 요청은 한국어로 써도 되고, 결과는 영어 설명문으로 나옵니다. 생각 과정은 필요 없으므로 `options.think`를 `0`으로 보냅니다.
```bash
curl -s -X POST "https://api-N.flameai.im/{my_base_path}/cortex/{업샘플러 cortexId}/messages" \
-H "Authorization: Bearer {Secret Key}" \
-H "Content-Type: application/json" \
-d '{
"conversationId": "flux-prompt-001",
"options": { "think": 0, "cortex_reset": true },
"messages": [
{ "role": "system", "content": "{system_prompts.json 의 t2i 프롬프트}" },
{ "role": "user", "content": "비 오는 밤, 네온 간판이 빛나는 좁은 골목" }
]
}'
```
5. **이미지 생성** — 응답의 `text` 블록(영어 설명문)을 `imageGenerate`의 `prompt`로 그대로 넣습니다.
```bash
curl -s -X POST "https://api-N.flameai.im/{my_base_path}/cortex/{FLUX 3 cortexId}/imageGenerate" \
-H "Authorization: Bearer {Secret Key}" \
-H "Content-Type: application/json" \
-d '{ "prompt": "{업샘플러가 만든 영어 설명문}", "width": 1024, "height": 1024, "steps": 16, "cfg_scale": 1.0, "seed": -1 }'
```
6. **이미지 받기** — 응답의 `files`에 있는 파일 이름으로 Cortex 파일 API(`GET …/cortex/{cortexId}/files/{name}`)에서 내려받습니다. 다운로드에는 `Authorization` 헤더가 필요해 브라우저 `<img src>`에 주소를 바로 넣을 수는 없습니다.
* `"stream": true`로 보내면 SSE로 진행 상황(`generation.progress`)을 받다가 마지막에 `generation.result`로 결과를 받습니다.
* 이미지 Cortex는 이미지 생성 전용입니다. `messages` 등 LLM용 요청은 `unsupported_cortex_type` 에러로 거절됩니다.
* `my_base_path`와 `Secret Key`는 My AI Console의 API 설정 화면에서 확인할 수 있습니다.
## 활용 분야
* 마케팅·SNS 이미지, 배너, 포스터 제작
* 상품 이미지, 썸네일, 블로그 삽화 자동 생성
* 참조 이미지로 인물·제품을 유지한 합성 이미지
* LLM Cortex와 연결한 자동화 — 글 작성 → 내용에 맞는 이미지 생성
* 사내 데이터·이미지를 외부로 보내지 않는 온프레미스 이미지 생성
## 제한 사항
* **라이선스**: FLUX Kommunity License에 따라 연 매출 500만 달러 미만의 개인·기업은 상업적으로 무료로 쓸 수 있습니다. 그 이상의 기업이 상업적으로 쓰려면 Black Forest Labs와 별도 라이선스가 필요합니다.
* **짧은 프롬프트는 결과가 평범합니다.** 프롬프트 업샘플러를 쓰거나, 영어로 자세하게 써야 합니다.
* **FlameAI 미검증 항목**: FLUX 3 Image Klein은 FlameAI 이미지 엔진에서 아직 실측·검증 기록이 없습니다. 참조 이미지 편집, 바운딩 박스 레이아웃, 2K 이상 해상도, Klein Base 실행, macOS 실행도 검증하지 않았습니다.
* 이미지 생성 Cortex는 한 번에 하나씩 생성합니다. 같은 PC의 여러 이미지 요청은 순서대로 처리됩니다.
* 비트 수가 낮은 양자화(Q2 등)일수록 이미지 품질이 떨어질 수 있습니다.
## 참고
* Black Forest Labs 블로그 — FLUX 3 Image Klein: https://bfl.ai/blog/flux-3-image-klein
* Hugging Face — FLUX 3 Image Klein: https://huggingface.co/black-forest-labs/flux-3-image-klein
* Hugging Face — FLUX 3 Image Klein Base: https://huggingface.co/black-forest-labs/flux-3-image-klein-base
* Hugging Face — FLUX 3 Prompt Upsampler (시스템 프롬프트 `system_prompts.json`): https://huggingface.co/black-forest-labs/flux-3-image-klein-pup
* ComfyUI 공식 가이드 (권장 steps·CFG): https://docs.comfy.org/tutorials/flux/flux-3-klein
* GitHub — 추론 코드: https://github.com/black-forest-labs/flux-3-image-klein
* GGUF 양자화 (Unsloth): https://huggingface.co/unsloth/flux-3-image-klein-GGUF
* 실행 엔진 stable-diffusion.cpp: https://github.com/leejet/stable-diffusion.cpp
