Overcoming the 77-token prompt limitation, generating long-weighted prompt embeddings for Stable Diffusion, this module supports generating embedding and pooled embeddings for long prompt weighted. The generated embedding is compatible with Huggingface Diffusers.
The prompt format is compatible with AUTOMATIC1111 stable-diffusion-webui
- Support unlimited prompt length for SD1.5 and SDXL
- Support weighting like
a (white:1.2) cat - Support parentheses like
a ((white)) cat - For SD3, support max 512 tokens (T5 model support max 512 tokens)
Support Stable Diffusion v1.5, SDXL and Stable Diffusion 3.
The detailed implementation is covered in chapter 10 of book Using Stable Diffusion with Python
[09/10/2024] Add Stable Cascade long prompt support, check out
samples/lpw_stablecascade.pyfile to see the usage sample.[08/29/2024] Add a tool to convert Civitai.com FLUX model to Diffusers format. see sample code in
samples/convert_civitai_safetensor_to_diffusers.py[08/28/2024] Support
pipe.enable_model_cpu_offload(), update sample code to usetorchao, reduce VRAM usage.[08/06/2024] Add FLUX.1 long prompt support, check out
samples/lpw_flux1.pyfile to see the usage sample.[06/30/2024] Add support Stable Diffusion 3 pipeline without T5 encoder.
install torchao:
pip install torchao --extra-index-url https://download.pytorch.org/whl/cu121 # full options are cpu/cu118/cu121/cu124
See more detail at torchao
Install sd_embed:
pip install git+https://github.com/xhinker/sd_embed.git@mainFlux.1 embedding usage
To use Flux.1 in a 24G VRAM GPU, we need to quantize the Transformer model and T5 text encoder model to qfloat8 using optimum-quanto. see Quanto: a PyTorch quantization backend for Optimum and Memory-efficient Diffusion Transformers with Quanto and Diffusers to convert Diffusion model weights to qfloat8 so that we can use Flux in a 24G VRAM with Diffusers.
Here is the complete usage sample:
fromdiffusersimportDiffusionPipeline, FluxTransformer2DModelfromtorchao.quantizationimportquantize_, int8_weight_onlyimporttorchfromsd_embed.embedding_funcsimportget_weighted_text_embeddings_flux1# model_path = "black-forest-labs/FLUX.1-schnell"model_path="/home/andrewzhu/storage_14t_5/ai_models_all/sd_hf_models/black-forest-labs/FLUX.1-dev_main"transformer=FluxTransformer2DModel.from_pretrained(
model_path
, subfolder="transformer"
, torch_dtype=torch.bfloat16
)
quantize_(transformer, int8_weight_only())
pipe=DiffusionPipeline.from_pretrained(
model_path
, transformer=transformer
, torch_dtype=torch.bfloat16
)
pipe.enable_model_cpu_offload()
#%%prompt="""\A dreamy, soft-focus photograph capturing a romantic Jane Austen movie scene, in the style of Agnes Cecile. Delicate watercolors, misty background, Regency-era couple, tender embrace, period clothing, flowing dress, dappled sunlight, ethereal glow, gentle expressions, intricate lace, muted pastels, serene countryside, timeless romance, poetic atmosphere, wistful mood, look at camera."""prompt_embeds, pooled_prompt_embeds=get_weighted_text_embeddings_flux1(
pipe=pipe
, prompt=prompt
)
image=pipe(
prompt_embeds=prompt_embeds
, pooled_prompt_embeds=pooled_prompt_embeds
, width=896
, height=1280
, num_inference_steps=20
, guidance_scale=4.0
, generator=torch.Generator().manual_seed(1234)
).images[0]
display(image)If you use FLUX.1-schnell, set num_inference_steps to 4.
Generate long prompt weighted embeddings for Stable Diffusion 3
Load up SD3 model:
importgcimporttorchfromdiffusersimportStableDiffusion3Pipelinefromsd_embed.embedding_funcsimportget_weighted_text_embeddings_sd3model_path="stabilityai/stable-diffusion-3-medium-diffusers"pipe=StableDiffusion3Pipeline.from_pretrained(
model_path,
torch_dtype=torch.float16
)Generate the embedding and use it to generate images:
pipe.to('cuda')
prompt="""A whimsical and creative image depicting a hybrid creature that is a mix of a waffle and a hippopotamus. This imaginative creature features the distinctive, bulky body of a hippo, but with a texture and appearance resembling a golden-brown, crispy waffle. The creature might have elements like waffle squares across its skin and a syrup-like sheen. It's set in a surreal environment that playfully combines a natural water habitat of a hippo with elements of a breakfast table setting, possibly including oversized utensils or plates in the background. The image should evoke a sense of playful absurdity and culinary fantasy."""neg_prompt="""\skin spots,acnes,skin blemishes,age spot,(ugly:1.2),(duplicate:1.2),(morbid:1.21),(mutilated:1.2),\(tranny:1.2),mutated hands,(poorly drawn hands:1.5),blurry,(bad anatomy:1.2),(bad proportions:1.3),\extra limbs,(disfigured:1.2),(missing arms:1.2),(extra legs:1.2),(fused fingers:1.5),\(too many fingers:1.5),(unclear eyes:1.2),lowers,bad hands,missing fingers,extra digit,\bad hands,missing fingers,(extra arms and legs),(worst quality:2),(low quality:2),\(normal quality:2),lowres,((monochrome)),((grayscale))"""
(
prompt_embeds
, prompt_neg_embeds
, pooled_prompt_embeds
, negative_pooled_prompt_embeds
) =get_weighted_text_embeddings_sd3(
pipe
, prompt=prompt
, neg_prompt=neg_prompt
)
image=pipe(
prompt_embeds=prompt_embeds
, negative_prompt_embeds=prompt_neg_embeds
, pooled_prompt_embeds=pooled_prompt_embeds
, negative_pooled_prompt_embeds=negative_pooled_prompt_embeds
, num_inference_steps=30
, height=1024 , width=1024+512
, guidance_scale=4.0
, generator=torch.Generator("cuda").manual_seed(2)
).images[0]
display(image)
delprompt_embeds, prompt_neg_embeds,pooled_prompt_embeds, negative_pooled_prompt_embedspipe.to('cpu')
gc.collect()
torch.cuda.empty_cache()Using long weighted embedding result:
Without long prompt weighted embedding result:
Stable Cascade embedding usage sample
To use the long prompt weighted embedding for Stable Cascade, simply import the embedding function - from sd_embed.embedding_funcs import get_weighted_text_embeddings_s_cascade for stable cascade.
importgcimporttorchfromsd_embed.embedding_funcsimportget_weighted_text_embeddings_s_cascadefromdiffusersimportStableCascadePriorPipeline, StableCascadeDecoderPipelineprior=StableCascadePriorPipeline.from_pretrained(
"stabilityai/stable-cascade-prior",
variant='bf16',
torch_dtype=torch.bfloat16)
decoder=StableCascadeDecoderPipeline.from_pretrained(
"stabilityai/stable-cascade",
variant='bf16',
torch_dtype=torch.float16)
prompt="""A whimsical and creative image depicting a hybrid creature that is a mix of a waffle and a hippopotamus. This imaginative creature features the distinctive, bulky body of a hippo, but with a texture and appearance resembling a golden-brown, crispy waffle. The creature might have elements like waffle squares across its skin and a syrup-like sheen. It's set in a surreal environment that playfully combines a natural water habitat of a hippo with elements of a breakfast table setting, possibly including oversized utensils or plates in the background. The image should evoke a sense of playful absurdity and culinary fantasy."""neg_prompt="""\skin spots,acnes,skin blemishes,age spot,(ugly:1.2),(duplicate:1.2),(morbid:1.21),(mutilated:1.2),\(tranny:1.2),mutated hands,(poorly drawn hands:1.5),blurry,(bad anatomy:1.2),(bad proportions:1.3),\extra limbs,(disfigured:1.2),(missing arms:1.2),(extra legs:1.2),(fused fingers:1.5),\(too many fingers:1.5),(unclear eyes:1.2),lowers,bad hands,missing fingers,extra digit,\bad hands,missing fingers,(extra arms and legs),(worst quality:2),(low quality:2),\(normal quality:2),lowres,((monochrome)),((grayscale))"""generator=torch.Generator(device='cuda').manual_seed(3)
# priorprior.to('cuda')
(
prompt_embeds
, negative_prompt_embeds
, pooled_prompt_embeds
, negative_prompt_embeds_pooled
) =get_weighted_text_embeddings_s_cascade(prior, prompt, neg_prompt)
prior_output=prior(
prompt_embeds=prompt_embeds
, negative_prompt_embeds=negative_prompt_embeds
, prompt_embeds_pooled=pooled_prompt_embeds
, negative_prompt_embeds_pooled=negative_prompt_embeds_pooled
, num_inference_steps=30
, guidance_scale=8
, height=1024
, width=1024+512
, generator=generator
)
delprompt_embeds, pooled_prompt_embeds, negative_prompt_embeds, negative_prompt_embeds_pooledprior.to('cpu')
# decoderdecoder.to('cuda')
(
prompt_embeds
, negative_prompt_embeds
, pooled_prompt_embeds
, negative_prompt_embeds_pooled
) =get_weighted_text_embeddings_s_cascade(decoder, prompt, neg_prompt)
image=decoder(
prompt_embeds=prompt_embeds
, negative_prompt_embeds=negative_prompt_embeds
, prompt_embeds_pooled=pooled_prompt_embeds
, negative_prompt_embeds_pooled=negative_prompt_embeds_pooled
, image_embeddings=prior_output.image_embeddings.half()
, num_inference_steps=10
, guidance_scale=0
, generator=generator
).images[0]
display(image)
delprompt_embeds, pooled_prompt_embeds, negative_prompt_embeds, negative_prompt_embeds_pooleddecoder.to('cpu')
gc.collect()
torch.cuda.empty_cache()Using long prompt weighted embedding:
Without using long prompt weighted embedding:
SDXL embedding usage sample
To use the long prompt weighted embedding for SDXL, simply import the embedding function - from sd_embed.embedding_funcs import get_weighted_text_embeddings_sdxl for sdxl.
importgcimporttorchfromdiffusersimportStableDiffusionXLPipelinefromsd_embed.embedding_funcsimportget_weighted_text_embeddings_sdxlmodel_path="Lykon/dreamshaper-xl-1-0"pipe=StableDiffusionXLPipeline.from_pretrained(
model_path,
torch_dtype=torch.float16
)
pipe.to('cuda')
prompt="""A whimsical and creative image depicting a hybrid creature that is a mix of a waffle and a hippopotamus. This imaginative creature features the distinctive, bulky body of a hippo, but with a texture and appearance resembling a golden-brown, crispy waffle. The creature might have elements like waffle squares across its skin and a syrup-like sheen. It's set in a surreal environment that playfully combines a natural water habitat of a hippo with elements of a breakfast table setting, possibly including oversized utensils or plates in the background. The image should evoke a sense of playful absurdity and culinary fantasy."""neg_prompt="""\skin spots,acnes,skin blemishes,age spot,(ugly:1.2),(duplicate:1.2),(morbid:1.21),(mutilated:1.2),\(tranny:1.2),mutated hands,(poorly drawn hands:1.5),blurry,(bad anatomy:1.2),(bad proportions:1.3),\extra limbs,(disfigured:1.2),(missing arms:1.2),(extra legs:1.2),(fused fingers:1.5),\(too many fingers:1.5),(unclear eyes:1.2),lowers,bad hands,missing fingers,extra digit,\bad hands,missing fingers,(extra arms and legs),(worst quality:2),(low quality:2),\(normal quality:2),lowres,((monochrome)),((grayscale))"""
(
prompt_embeds
, prompt_neg_embeds
, pooled_prompt_embeds
, negative_pooled_prompt_embeds
) =get_weighted_text_embeddings_sdxl(
pipe
, prompt=prompt
, neg_prompt=neg_prompt
)
image=pipe(
prompt_embeds=prompt_embeds
, negative_prompt_embeds=prompt_neg_embeds
, pooled_prompt_embeds=pooled_prompt_embeds
, negative_pooled_prompt_embeds=negative_pooled_prompt_embeds
, num_inference_steps=30
, height=1024 , width=1024+512
, guidance_scale=4.0
, generator=torch.Generator("cuda").manual_seed(2)
).images[0]
display(image)
delprompt_embeds, prompt_neg_embeds,pooled_prompt_embeds, negative_pooled_prompt_embedspipe.to('cpu')
gc.collect()
torch.cuda.empty_cache()Using long prompt weighted embedding:
Without using long prompt weighted embedding:
Stable Diffusion V1.5 usage sample
To use the long prompt weighted embedding for SDXL, use the embedding function - get_weighted_text_embeddings_sd15.
importgcimporttorchfromdiffusersimportStableDiffusionPipelinefromsd_embed.embedding_funcsimportget_weighted_text_embeddings_sd15model_path="stablediffusionapi/deliberate-v2"pipe=StableDiffusionPipeline.from_pretrained(
model_path,
torch_dtype=torch.float16
)
pipe.to('cuda')
prompt="""A whimsical and creative image depicting a hybrid creature that is a mix of a waffle and a hippopotamus. This imaginative creature features the distinctive, bulky body of a hippo, but with a texture and appearance resembling a golden-brown, crispy waffle. The creature might have elements like waffle squares across its skin and a syrup-like sheen. It's set in a surreal environment that playfully combines a natural water habitat of a hippo with elements of a breakfast table setting, possibly including oversized utensils or plates in the background. The image should evoke a sense of playful absurdity and culinary fantasy."""neg_prompt="""\skin spots,acnes,skin blemishes,age spot,(ugly:1.2),(duplicate:1.2),(morbid:1.21),(mutilated:1.2),\(tranny:1.2),mutated hands,(poorly drawn hands:1.5),blurry,(bad anatomy:1.2),(bad proportions:1.3),\extra limbs,(disfigured:1.2),(missing arms:1.2),(extra legs:1.2),(fused fingers:1.5),\(too many fingers:1.5),(unclear eyes:1.2),lowers,bad hands,missing fingers,extra digit,\bad hands,missing fingers,(extra arms and legs),(worst quality:2),(low quality:2),\(normal quality:2),lowres,((monochrome)),((grayscale))"""
(
prompt_embeds
, prompt_neg_embeds
) =get_weighted_text_embeddings_sd15(
pipe
, prompt=prompt
, neg_prompt=neg_prompt
)
image=pipe(
prompt_embeds=prompt_embeds
, negative_prompt_embeds=prompt_neg_embeds
, num_inference_steps=30
, height=768
, width=896
, guidance_scale=8.0
, generator=torch.Generator("cuda").manual_seed(2)
).images[0]
display(image)
delprompt_embeds, prompt_neg_embedspipe.to('cpu')
gc.collect()
torch.cuda.empty_cache()Using long prompt weighted embedding:
Without using long prompt weighted embedding:
If you use sd_embed in your research, please cite the following work:
@misc{sd_embed_2024,
author = {Shudong Zhu(Andrew Zhu)},
title = {Long Prompt Weighted Stable Diffusion Embedding},
howpublished = {\url{https://github.com/xhinker/sd_embed}},
year = {2024},
}