bytedance/pulid

📖 PuLID: Pure and Lightning ID Customization via Contrastive Alignment

Capabilities

Negative PromptSeed

Cost

Community model (estimated from hardware time)

Input Parameters

Name	Type	Description	Default	Constraints
`main_face_image`*	string(uri)	ID image (main)	`—`	—
`auxiliary_face_image1`	string(uri)	Additional ID image (auxiliary)	`—`	—
`auxiliary_face_image2`	string(uri)	Additional ID image (auxiliary)	`—`	—
`auxiliary_face_image3`	string(uri)	Additional ID image (auxiliary)	`—`	—
`cfg_scale`	number	CFG, recommend value range [1, 1.5], 1 will be faster	`1.2`	min: 1, max: 1.5
`generation_mode`	string	mode	`"fidelity"`	fidelityextremely style
`identity_scale`	number	ID scale	`0.8`	min: 0, max: 5
`image_height`	integer	Height	`1024`	min: 512, max: 2024
`image_width`	integer	Width	`768`	min: 512, max: 2024
`mix_identities`	boolean	ID Mix (if you want to mix two ID image, please turn this on, otherwise, turn this off)	`false`	—
`negative_prompt`	string	Negative Prompt	`"flaws in the eyes, flaws in the face, flaws, lowres, non-HDRi, low quality, worst quality,artifacts noise, text, watermark, glitch, deformed, mutated, ugly, disfigured, hands, low resolution, partially rendered objects, deformed or partially rendered eyes, deformed, deformed eyeballs, cross-eyed,blurry"`	—
`num_samples`	integer	Num samples	`4`	min: 1, max: 8
`num_steps`	integer	Steps	`4`	min: 1, max: 100
`output_format`	string	Format of the output images	`"webp"`	webpjpgpng
`output_quality`	integer	Quality of the output images, from 0 to 100. 100 is best quality, 0 is lowest quality.	`80`	min: 0, max: 100
`prompt`	string	Prompt	`"portrait,color,cinematic,in garden,soft light,detailed face"`	—
`seed`	integer	Random seed. Leave blank to randomize the seed	`—`	—

main_face_imagerequiredstring

ID image (main)

auxiliary_face_image1string

Additional ID image (auxiliary)

auxiliary_face_image2string

Additional ID image (auxiliary)

auxiliary_face_image3string

Additional ID image (auxiliary)

cfg_scalenumber

CFG, recommend value range [1, 1.5], 1 will be faster

Default: 1.2min: 1, max: 1.5

generation_modestring

mode

Default: "fidelity"

fidelityextremely style

identity_scalenumber

ID scale

Default: 0.8min: 0, max: 5

image_heightinteger

Height

Default: 1024min: 512, max: 2024

image_widthinteger

Width

Default: 768min: 512, max: 2024

mix_identitiesboolean

ID Mix (if you want to mix two ID image, please turn this on, otherwise, turn this off)

Default: false

negative_promptstring

Negative Prompt

Default:

"flaws in the eyes, flaws in the face, flaws, lowres, non-HDRi, low quality, worst quality,artifacts noise, text, watermark, glitch, deformed, mutated, ugly, disfigured, hands, low resolution, partially rendered objects,  deformed or partially rendered eyes, deformed, deformed eyeballs, cross-eyed,blurry"

num_samplesinteger

Num samples

Default: 4min: 1, max: 8

num_stepsinteger

Steps

Default: 4min: 1, max: 100

output_formatstring

Format of the output images

Default: "webp"

webpjpgpng

output_qualityinteger

Quality of the output images, from 0 to 100. 100 is best quality, 0 is lowest quality.

Default: 80min: 0, max: 100

promptstring

Prompt

Default: "portrait,color,cinematic,in garden,soft light,detailed face"

seedinteger

Random seed. Leave blank to randomize the seed

Version: 43d309c37ab4Updated: 7/25/20263.9M runs