bytedance/flux-pulid
⚡️FLUX PuLID: FLUX-dev based Pure and Lightning ID Customization via Contrastive Alignment🎭
Capabilities
Cost
Community model (estimated from hardware time)
Input Parameters
| Name | Type | Description | Default | Constraints |
|---|---|---|---|---|
main_face_image * | string (uri) | Upload an ID image for face generation | — | — |
guidance_scale | number | Set the guidance scale for text prompt influence (1.0-10.0) | 4 | min: 1, max: 10 |
height | integer | Set the height of the generated image (256-1536 pixels) | 1152 | min: 256, max: 1536 |
id_weight | number | Set the weight of the ID image influence (0.0-3.0) | 1 | min: 0, max: 3 |
max_sequence_length | integer | Set the max sequence length for prompt (T5), smaller is faster (128-512) | 128 | min: 128, max: 512 |
negative_prompt | string | Enter a negative prompt to specify what to avoid in the image | "bad quality, worst quality, text, signature, watermark, extra limbs, low resolution, partially rendered objects, deformed or partially rendered eyes, deformed, deformed eyeballs, cross-eyed, blurry" | — |
num_outputs | integer | Set the number of images to generate (1-4) | 1 | min: 1, max: 4 |
num_steps | integer | Set the number of denoising steps (1-20) | 20 | min: 1, max: 20 |
output_format | string | Choose the format of the output image | "webp" | png jpg webp |
output_quality | integer | Set the quality of the output image for jpg and webp (1-100) | 80 | min: 1, max: 100 |
prompt | string | Enter a text prompt to guide image generation | "portrait, color, cinematic" | — |
seed | integer | Set a random seed for generation (leave blank or -1 for random) | — | — |
start_step | integer | Set the timestep to start inserting ID (0-4 recommended, 0 for highest fidelity, 4 for more editability) | 0 | min: 0, max: 10 |
true_cfg | number | Set the Classifier-Free Guidance (CFG) scale. 1.0 uses standard CFG, while values >1.0 enable True CFG for more precise control over generation. Higher values increase adherence to the prompt at the cost of image quality. | 1 | min: 1, max: 10 |
width | integer | Set the width of the generated image (256-1536 pixels) | 896 | min: 256, max: 1536 |
main_face_image required string Upload an ID image for face generation
guidance_scale number Set the guidance scale for text prompt influence (1.0-10.0)
4 min: 1, max: 10 height integer Set the height of the generated image (256-1536 pixels)
1152 min: 256, max: 1536 id_weight number Set the weight of the ID image influence (0.0-3.0)
1 min: 0, max: 3 max_sequence_length integer Set the max sequence length for prompt (T5), smaller is faster (128-512)
128 min: 128, max: 512 negative_prompt string Enter a negative prompt to specify what to avoid in the image
"bad quality, worst quality, text, signature, watermark, extra limbs, low resolution, partially rendered objects, deformed or partially rendered eyes, deformed, deformed eyeballs, cross-eyed, blurry" num_outputs integer Set the number of images to generate (1-4)
1 min: 1, max: 4 num_steps integer Set the number of denoising steps (1-20)
20 min: 1, max: 20 output_format string Choose the format of the output image
"webp" output_quality integer Set the quality of the output image for jpg and webp (1-100)
80 min: 1, max: 100 prompt string Enter a text prompt to guide image generation
"portrait, color, cinematic" seed integer Set a random seed for generation (leave blank or -1 for random)
start_step integer Set the timestep to start inserting ID (0-4 recommended, 0 for highest fidelity, 4 for more editability)
0 min: 0, max: 10 true_cfg number Set the Classifier-Free Guidance (CFG) scale. 1.0 uses standard CFG, while values >1.0 enable True CFG for more precise control over generation. Higher values increase adherence to the prompt at the cost of image quality.
1 min: 1, max: 10 width integer Set the width of the generated image (256-1536 pixels)
896 min: 256, max: 1536 8baa7ef22550 Updated: 2/26/2026 2.5M runs
cinemasetfree.com