FLUX：Black Forest Labs 开源权重图像生成与编辑模型系列｜部署与使用全指南
项目仓库： https://github.com/black-forest-labs/flux
官方文档：docs.bfl.ai · 维护方：Black Forest Labs（Stability AI 核心团队出走创立） · 语言：Python 3.10 · 形态：最小推理代码 + CLI · 许可证：schnell 为 Apache-2.0，dev 系列为非商业许可
1 项目简介
FLUX 是 Black Forest Labs
推出的图像生成模型系列。本仓库提供最小推理代码，覆盖文生图、In/Out-painting、结构条件（Canny/Depth）、图像变体、图像编辑（Kontext）等任务。模型权重以开放权重形式发布在
Hugging Face：FLUX.1 [schnell]（Apache-2.0，可商用）与
FLUX.1 [dev]（非商业研究许可）。
1.1 核心信息一览
| 项目项 | 内容 |
|---|---|
| 项目名称 | FLUX |
| 仓库地址 | github.com/black-forest-labs/flux |
| 官方站 | bfl.ai / docs.bfl.ai |
| 维护方 | Black Forest Labs |
| 形态 | Python 3.10 最小推理代码 + CLI |
| 可商用模型 | FLUX.1 [schnell]（Apache-2.0） |
| 非商业模型 | FLUX.1 [dev] 系列 |
1.2 模型矩阵
| 模型 | 用途 | 许可证 |
|---|---|---|
| FLUX.1 [schnell] | 文生图（快速） | Apache-2.0 |
| FLUX.1 [dev] | 文生图（高质量） | 非商业 |
| FLUX.1 Fill [dev] | In/Out-painting | 非商业 |
| FLUX.1 Canny/Depth [dev] | 结构条件 | 非商业 |
| FLUX.1 Redux [dev] | 图像变体 | 非商业 |
| FLUX.1 Kontext [dev] | 图像编辑 | 非商业 |
| FLUX.1 Krea [dev] | 文生图 | 非商业 |
1.3 适用场景
- 文生图、局部重绘、结构控制、图像变体与编辑。
- 需要可商用（schnell）或研究（dev）的高质量开源图像模型。
2 功能特性
- 文生图 / 图生图 / 编辑：一个仓库覆盖多种任务。
- 最小推理代码：不绑定重型框架，易读易改。
- TensorRT 可选：NVIDIA 容器可加速。
- API 与用量追踪：商业使用可通过 BFL API 自动追踪用量。
3 官方界面预览
官方在线 API 见 docs.bfl.ai；本地用 CLI 调用。
4 官方跳转链接汇总
| 类别 | 链接 | 说明 |
|---|---|---|
| 仓库 | github.com/black-forest-labs/flux | 推理代码 |
| API 文档 | docs.bfl.ai | API 用法 |
| 模型权重 | huggingface.co/black-forest-labs | 全部开源权重 |
| 商业授权 | bfl.ai/pricing/licensing | dev 模型商用授权 |
5 前置要求与服务器配置
5.1 软件前提
- Python 3.10。
- PyTorch（CUDA）。
- 克隆仓库后
pip install -e ".[all]"。
5.2 硬件建议
FLUX 模型较大，建议 24 GB 显存以上；schnell 蒸馏版可在较小显存跑。
6 方式一：本地安装与推理
cd $HOME
git clone https://github.com/black-forest-labs/flux
cd $HOME/flux
python3.10 -m venv .venv
source .venv/bin/activate
pip install -e ".[all]"6.1 TensorRT 加速（可选）
enroot import 'docker://$oauthtoken@nvcr.io#nvidia/pytorch:25.01-py3'
enroot create -n pti2501 nvidia+pytorch+25.01-py3.sqsh
enroot start --rw -m ${PWD}/flux:/workspace/flux -r pti2501
cd flux
pip install -e ".[tensorrt]" --extra-index-url https://pypi.nvidia.com6.2 Kontext 图像编辑（带用量追踪）
export BFL_API_KEY="your_api_key_here"
python -m flux kontext --track_usage --loop
# 单次生成
python -m flux kontext --track_usage \
--prompt "replace the logo with the text 'Black Forest Labs'"7 模型权重下载
权重在 Hugging Face：
- schnell：black-forest-labs/FLUX.1-schnell
- dev：black-forest-labs/FLUX.1-dev
- Fill/Canny/Depth/Redux/Kontext/Krea 各有独立仓。
8 关键参数
| 参数 | 说明 |
|---|---|
--prompt |
文本提示词 |
--track_usage |
商业用量追踪 |
--loop |
交互循环模式 |
9 常用运维命令
nvidia-smi
ls -lh checkpoints/10 常见故障排查
- 显存不足：用 schnell 蒸馏版或开启 CPU offload。
- dev 模型商用：必须先在 bfl.ai/pricing/licensing 取得商业授权。
- API key：商业使用需配置
BFL_API_KEY。
11 风险与合规说明
- 许可证差异：schnell 是 Apache-2.0 可商用；dev 系列是非商业许可，商用必须单独授权。
- 输出图像版权由使用者承担；不得用于伪造、侵权内容。
- 官方 API 与开权重是两条线，开源版不提供 SLA。
本文基于官方 README 整理，仅供学习与部署参考；以仓库最新说明为准。