🚀 用于Stable Diffusion 2.1的二维码条件ControlNet模型

本项目提供了基于二维码条件的ControlNet模型，适用于Stable Diffusion 2.1。该模型可助力用户在图像生成过程中，依据二维码条件生成特定图像，为图像创作带来更多可能性。

🚀 快速开始

本模型提供了safetensors和diffusers两种版本，适用于Stable Diffusion v2.1。Stable Diffusion 2.1版本效果稍好，是为满足特定需求而开发的。不过，也在相同数据集上训练了1.5版本的模型，供使用旧版本的用户使用。

✨ 主要特性

• 支持Stable Diffusion 2.1和1.5版本。
• 可根据二维码条件生成特定图像。
• 提供safetensors和diffusers两种版本。

📦 安装指南

使用diffusers库

pip -q install diffusers transformers accelerate torch xformers

在auto1111中使用

将.safetensors模型及其.yaml配置文件放在其他ControlNet模型的安装文件夹中，具体位置因应用而异。在auto1111中，可将其放在webui/models/ControlNet文件夹中。可以使用ControlNet WebUI扩展加载模型，该扩展可通过WebUI的扩展选项卡安装（https://github.com/Mikubill/sd-webui-controlnet）。

💻 使用示例

基础用法

import torch
from PIL import Image
from diffusers import StableDiffusionControlNetImg2ImgPipeline, ControlNetModel, DDIMScheduler
from diffusers.utils import load_image

controlnet = ControlNetModel.from_pretrained("DionTimmer/controlnet_qrcode-control_v11p_sd21",
                                             torch_dtype=torch.float16)

pipe = StableDiffusionControlNetImg2ImgPipeline.from_pretrained(
    "stabilityai/stable-diffusion-2-1",
    controlnet=controlnet,
    safety_checker=None,
    torch_dtype=torch.float16
)

pipe.enable_xformers_memory_efficient_attention()
pipe.scheduler = DDIMScheduler.from_config(pipe.scheduler.config)
pipe.enable_model_cpu_offload()

def resize_for_condition_image(input_image: Image, resolution: int):
    input_image = input_image.convert("RGB")
    W, H = input_image.size
    k = float(resolution) / min(H, W)
    H *= k
    W *= k
    H = int(round(H / 64.0)) * 64
    W = int(round(W / 64.0)) * 64
    img = input_image.resize((W, H), resample=Image.LANCZOS)
    return img


# play with guidance_scale, controlnet_conditioning_scale and strength to make a valid QR Code Image

# qr code image
source_image = load_image("https://s3.amazonaws.com/moonup/production/uploads/6064e095abd8d3692e3e2ed6/A_RqHaAM6YHBodPLwqtjn.png")
# initial image, anything
init_image = load_image("https://s3.amazonaws.com/moonup/production/uploads/noauth/KfMBABpOwIuNolv1pe3qX.jpeg")
condition_image = resize_for_condition_image(source_image, 768)
init_image = resize_for_condition_image(init_image, 768)
generator = torch.manual_seed(123121231)
image = pipe(prompt="a bilboard in NYC with a qrcode",
             negative_prompt="ugly, disfigured, low quality, blurry, nsfw", 
             image=init_image,
             control_image=condition_image,
             width=768,
             height=768,
             guidance_scale=20,
             controlnet_conditioning_scale=1.5,
             generator=generator,
             strength=0.9, 
             num_inference_steps=150,
            )

image.images[0]

📚 详细文档

性能与局限性

这些模型在大多数情况下表现良好，但请注意，它们并非100%准确。在某些情况下，二维码形状可能无法按预期呈现。可以增加ControlNet的权重以强调二维码形状，但要注意这可能会对输出风格产生负面影响。为了优化扫描效果，请使用纠错模式'H'（30%）生成二维码。

为了在风格和形状之间取得平衡，可能需要根据具体输入、期望输出以及正确的提示词对控制权重进行微调。有些提示词在大幅增加权重之前可能不起作用。找到这些因素之间的正确平衡既是一门艺术，也是一门科学。为了获得最佳效果，建议以768的分辨率生成艺术作品，这样可以在最终产品中实现更高的细节水平，提高基于二维码的艺术作品的质量和效果。

注意事项

• 确保启用ControlNet单元，并将输入图像设置为二维码。
• 根据基础Stable Diffusion模型选择SD2.1或1.5版本的模型，否则会出错。
• 不需要预处理器，但可以使用反转预处理器以获得不同的结果。
• 生成时首选768的分辨率，以便获得更多细节。

📄 许可证

本项目采用OpenRAIL++许可证。