Qr Code

🚀 適用於Stable Diffusion 1.5的二維碼條件ControlNet模型

本項目提供適用於Stable Diffusion 1.5的二維碼條件ControlNet模型，可用於圖像生成，在圖像中融入二維碼元素。

🚀 快速開始

安裝依賴

pip -q install diffusers transformers accelerate torch xformers

使用示例

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_v1p_sd15",
                                             torch_dtype=torch.float16)

pipe = StableDiffusionControlNetImg2ImgPipeline.from_pretrained(
    "runwayml/stable-diffusion-v1-5",
    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]

✨ 主要特性

• 本倉庫包含適用於Stable Diffusion v1.5的二維碼條件ControlNet的safetensors和diffusers版本。
• 雖然Stable Diffusion 2.1版本效果稍好，但此1.5版本模型也在相同數據集上進行了訓練，方便使用舊版本的用戶。

📦 安裝指南

將.safetensors模型及其.yaml配置文件放置在其他ControlNet模型的安裝文件夾中，具體位置因應用而異。

• 若在auto1111中使用，可將其放置在webui/models/ControlNet文件夾。
• 可通過webui的擴展選項卡安裝ControlNet擴展（https://github.com/Mikubill/sd-webui-controlnet）來加載模型。
• 確保啟用ControlNet單元，並將輸入圖像設置為二維碼。根據基礎Stable Diffusion模型選擇SD2.1或1.5版本的模型，否則會報錯。
• 無需預處理器，但可使用反轉預處理器以獲得不同的結果。建議以768的分辨率進行生成，以獲得更詳細的效果。

🔧 技術細節

性能與侷限性

這些模型在大多數情況下表現良好，但並非100%準確。在某些情況下，二維碼形狀可能不符合預期。可以增加ControlNet的權重來強調二維碼形狀，但需注意這可能會影響輸出的風格。為了優化掃描效果，請使用糾錯模式'H'（30%）生成二維碼。 為了在風格和形狀之間取得平衡，可能需要根據具體輸入、期望輸出以及正確的提示詞對控制權重進行微調。有些提示詞需要大幅增加權重才能生效。找到這些因素之間的最佳平衡既需要技巧也需要經驗。為了獲得最佳效果，建議以768的分辨率生成作品，這樣可以在最終產品中實現更高的細節水平，提高基於二維碼的作品的質量和效果。

📄 許可證

本項目使用的許可證為openrail++。