如何用一句话改图FLUX.1 Kontext 图像编辑实战指南【免费下载链接】fluxOfficial inference repo for FLUX.1 models项目地址: https://gitcode.com/GitHub_Trending/flux49/flux想把商品图上的 Logo 换成自己品牌、给图里的人换个发色或者连续多轮编辑同一张图还不跑偏这类需求靠传统加噪再重绘的 img2img 很难做好。FLUX.1 Kontext [dev]是 Black Forest Labs 开源的 12B 参数指令式图像编辑模型——你给一张图加一句自然语言指令它就直接改出一张新图人物、风格、物体保持一致无需任何微调。配合本仓库自带的命令行入口你在自己的显卡上就能完成本地推理。本仓库提供了开箱即用的 CLI一条python -m flux kontext命令即可首次运行会从 HuggingFace 自动拉取权重结果落到output/目录。下面带你走通完整路径从安装、权重准备到三步出图、交互编辑、加速省显存最后讲清楚商用前必须知道的许可条款。一句话就能改图靠的是什么Kontext 的核心能力可以概括为四条每条都对应你的一个实际收益按指令编辑现成图片——说把 Logo 换成 Black Forest Labs 字样模型只改该改的部分其余画面基本不动。免微调引用图中元素——图片里的角色、风格、物体可以直接在指令中提及一致性由模型本身保证。连环编辑不漂移——原图不是加噪重画而是作为序列条件拼进输入见 src/flux/sampling.py 中prepare_kontext位置编码的首维置 1 以区分参考图和待生成图所以同一张图编辑多轮也稳。推理更快——模型经 guidance distillation引导蒸馏把引导强度的效果提前训进权重里训练默认 30 步、guidance 2.5 即可出图比传统需要上百步的方案省时间。权重开源、本地可跑——仓库把flux-dev-kontext注册为独立模型配置src/flux/util.py 中与 FLUX.1 [dev] 同规格的 DiT 主干命令行直接可用。装好环境、备好权重一次性说清仓库要求 Python 3.10见 pyproject.toml安装只需四行git clone https://gitcode.com/GitHub_Trending/flux49/flux cd flux python3.10 -m venv .venv source .venv/bin/activate pip install -e .[all]权重有三种来源任选其一即可逻辑在 src/flux/util.py 的get_checkpoint_path自动下载默认推荐启动 demo 时自动从 HuggingFace 下到checkpoints/目录每个模型独立子目录。Kontext 属 gated 仓库首次需要登录 HuggingFace 并接受许可——用HF_TOKEN环境变量或huggingface-cli login认证代码检测到 gated repo 报错时会引导你补认证并重试。手动放置自行下载flux1-kontext-dev.safetensors模型权重和ae.safetensors自编码器负责像素↔潜空间转换放入checkpoints/对应目录。环境变量指定路径export FLUX_MODEL你的模型权重路径 export FLUX_AE你的自编码器路径三步跑通第一次图像编辑权重就绪后单条命令即可完成首次编辑输入图支持 jpg/jpeg/png/webppython -m flux kontext \ --img_cond_path assets/cup.png \ --prompt replace the logo with the text Black Forest Labs \ --num_steps 30 --guidance 2.5生成完打开output/img_0.jpg即可。输出图默认带 48 位隐形水印EXIF 里写入AI generated;img2img;flux、模型名和 promptJPEG 质量 95见 save_image。不指定--aspect_ratio时输出分辨率会取输入图宽高比最接近的一种训练分辨率17 种从 672x1568 到 1568x672这是模型训练时覆盖的尺寸效果最佳。像聊天一样反复编辑真正好用的方式是交互模式一条命令进会话python -m flux kontext --loop每轮先问下一句提示词再问输入图片路径提示词留空表示重复上一句图片留空表示沿用上一张。参数不用退出重跑斜杠命令实时调解析逻辑见 parse_prompt命令作用/ar 16:9设置输出宽高比/ar auto恢复跟随输入图/h 1024直接指定输出高度自动对齐到 16 的倍数/g 2.5设置引导强度越大越听话/n 30设置采样步数/s 1设置随机种子/q退出会话命令行单次调用常用参数速查完整签名见 cli_kontext.py 的main()参数默认值说明--img_cond_pathassets/cup.png待编辑的输入图--prompt换 Logo 示例指令编辑指令文本--num_steps30采样步数--guidance2.5引导强度--aspect_ratio跟随输入图如16:9面积固定约 1024²--seed随机固定后可复现结果--offloadFalse低显存模式--output_diroutput输出目录文件名img_{idx}.jpg自动续号--trtFalse启用 TensorRT 后端想更快、更省显存按你的硬件对号入座你的情况建议配置显存 ≥24GB开箱即用不加参数默认 bf16 路径显存 12~16GB加--offloadT5/CLIP/自编码器按需在 CPU/GPU 间搬运速度慢一些但能跑已装 NVIDIA PyTorch 容器、显存充足--trt --trt_transformer_precision fp8可选bf16、fp8、fp4_sdvd32按硬件与 TRT 环境支持挑选python -m flux kontext --loop --trt --trt_transformer_precision fp8注意 TRT 路径有额外前提需按 README 的 Local installation with TensorRT support 一节基于 NVIDIA PyTorch 容器安装并pip install -e .[tensorrt] --extra-index-url https://pypi.nvidia.comONNX 模型如black-forest-labs/FLUX.1-Kontext-dev-onnx同样在 gated 仓库首次也要认证。T5 精度由环境变量TRT_T5_PRECISION控制默认bf16可选fp8engine 缓存默认在checkpoints/trt_engines可用TRT_ENGINE_DIR覆盖。合法精度集合定义在 src/flux/trt/trt_manager.py。商用前必读的几条注意事项 ⚠️许可边界Kontext [dev] 遵循 FLUX.1-dev Non-Commercial Licensemodel_licenses/LICENSE-FLUX1-dev生成结果可用于个人与科研商用必须另行取得商业许可签约前逐条读完许可条款。内容过滤不替代人工审核CLI 对输入 prompt、输入图、输出图做三道检查——基于 pixtral-12b 视觉语言模型识别版权角色/商标/公众人物叠加 NSFW 分类器阈值 0.85实现见 src/flux/content_filters.py。被拦截时交互模式会提示重输单次模式直接结束。依许可要求部署时仍需配套过滤或人工审核机制。商用用量上报设好BFL_API_KEY环境变量后加--track_usage每次生成的数量会 POST 到 BFL 许可 API对应 slug 为flux-1-kontext-dev见 track_usage_via_api费用按月用量计算。输出可追溯水印 EXIF 标记默认开启--add_sampling_metadata控制 prompt 是否写入 EXIF交付前想清楚是否需要。常见坑与解决 ❓首次下载卡在认证 / 报 gated repo还没在 HuggingFace 接受许可。登录仓库页接受条款或用huggingface-cli login/ 设置HF_TOKEN后重跑命令。输出尺寸和输入图不一样正常现象。不指定--aspect_ratio时输出取 17 种训练分辨率中最接近输入图比例的一种不是原尺寸 1:1。想复现同一张结果加--seed固定种子想换效果就换种子或指令。显存溢出 (OOM)先加--offload还不够就用交互里的/ar或/h降分辨率。提示词或图片被拦截内容过滤命中商标 Logo、公众人物等常见。换个说法或换图重试别试图绕过滤——许可条款要求保留审核机制。小结FLUX.1 Kontext [dev] 让你用一句指令 一张图完成本地指令式改图--loop交互模式适合反复迭代TensorRT 适合追求速度的场景商用则务必先解决许可与用量上报。关键入口docs/image-editing.md官方使用文档、model_cards/FLUX.1-kontext-dev.md模型卡片、src/flux/cli_kontext.pyCLI 实现。【免费下载链接】fluxOfficial inference repo for FLUX.1 models项目地址: https://gitcode.com/GitHub_Trending/flux49/flux创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考