mirror of
https://www.modelscope.cn/black-forest-labs/FLUX.1-Fill-dev.git
synced 2026-04-02 18:12:55 +08:00
b54741692d
- add diffusers weights (03216e1d673120f9467575e1e84ff1ff21f2c29f) Co-authored-by: YiYi Xu <YiYiXu@users.noreply.huggingface.co>
90 lines
4.0 KiB
Markdown
90 lines
4.0 KiB
Markdown
---
|
|
language:
|
|
- en
|
|
license: other
|
|
license_name: flux-1-dev-non-commercial-license
|
|
license_link: LICENSE.md
|
|
extra_gated_prompt: By clicking "Agree", you agree to the [FluxDev Non-Commercial License Agreement](https://huggingface.co/black-forest-labs/FLUX.1-Fill-dev/blob/main/LICENSE.md)
|
|
and acknowledge the [Acceptable Use Policy](https://huggingface.co/black-forest-labs/FLUX.1-Fill-dev/blob/main/POLICY.md).
|
|
tags:
|
|
- image-generation
|
|
- flux
|
|
- diffusion-single-file
|
|
---
|
|
|
|
|
|
|
|
|
|
`FLUX.1 Fill [dev]` is a 12 billion parameter rectified flow transformer capable of filling areas in existing images based on a text description.
|
|
For more information, please read our [blog post](https://blackforestlabs.ai/flux-1-tools/).
|
|
|
|
# Key Features
|
|
1. Cutting-edge output quality, second only to our state-of-the-art model `FLUX.1 Fill [pro]`.
|
|
2. Blends impressive prompt following with completing the structure of your source image.
|
|
3. Trained using guidance distillation, making `FLUX.1 Fill [dev]` more efficient.
|
|
4. Open weights to drive new scientific research, and empower artists to develop innovative workflows.
|
|
5. Generated outputs can be used for personal, scientific, and commercial purposes as described in the [`FLUX.1 [dev]` Non-Commercial License](https://huggingface.co/black-forest-labs/FLUX.1-dev/blob/main/LICENSE.md).
|
|
|
|
# Usage
|
|
We provide a reference implementation of `FLUX.1 Fill [dev]`, as well as sampling code, in a dedicated [github repository](https://github.com/black-forest-labs/flux).
|
|
Developers and creatives looking to build on top of `FLUX.1 Fill [dev]` are encouraged to use this as a starting point.
|
|
|
|
## API Endpoints
|
|
The FLUX.1 models are also available in our API [bfl.ml](https://docs.bfl.ml/)
|
|
|
|
|
|
|
|
|
|
## Diffusers
|
|
|
|
To use `FLUX.1 Fill [dev]` with the 🧨 diffusers python library, first install or upgrade diffusers
|
|
|
|
```shell
|
|
pip install -U diffusers
|
|
```
|
|
|
|
Then you can use `FluxFillPipeline` to run the model
|
|
|
|
```python
|
|
import torch
|
|
from diffusers import FluxFillPipeline
|
|
from diffusers.utils import load_image
|
|
|
|
image = load_image("https://huggingface.co/datasets/diffusers/diffusers-images-docs/resolve/main/cup.png")
|
|
mask = load_image("https://huggingface.co/datasets/diffusers/diffusers-images-docs/resolve/main/cup_mask.png")
|
|
|
|
pipe = FluxFillPipeline.from_pretrained("black-forest-labs/FLUX.1-Fill-dev", torch_dtype=torch.bfloat16).to("cuda")
|
|
image = pipe(
|
|
prompt="a white paper cup",
|
|
image=image,
|
|
mask_image=mask,
|
|
height=1632,
|
|
width=1232,
|
|
guidance_scale=30,
|
|
num_inference_steps=50,
|
|
max_sequence_length=512,
|
|
generator=torch.Generator("cpu").manual_seed(0)
|
|
).images[0]
|
|
image.save(f"flux-fill-dev.png")
|
|
```
|
|
|
|
To learn more check out the [diffusers](https://huggingface.co/docs/diffusers/main/en/api/pipelines/flux) documentation
|
|
|
|
---
|
|
|
|
# Limitations
|
|
- This model is not intended or able to provide factual information.
|
|
- As a statistical model this checkpoint might amplify existing societal biases.
|
|
- The model may fail to generate output that matches the prompts.
|
|
- Prompt following is heavily influenced by the prompting-style.
|
|
- There may be slight-color shifts in areas that are not filled in
|
|
- Filling in complex textures may produce lines at the edges of the filled-area.
|
|
|
|
# Out-of-Scope Use
|
|
The model and its derivatives may not be used
|
|
|
|
- In any way that violates any applicable national, federal, state, local or international law or regulation.
|
|
- For the purpose of exploiting, harming or attempting to exploit or harm minors in any way; including but not limited to the solicitation, creation, acquisition, or dissemination of child exploitative content.
|
|
- To generate or disseminate verifiably false information and/or content with the purpose of harming others.
|
|
- To generate or disseminate personal identifiable information that can be used to harm an individual.
|
|
- To harass, abuse, threat |