bytedance / flux-pulid

⚡️FLUX PuLID: FLUX-dev based Pure and Lightning ID Customization via Contrastive Alignment🎭

Warm

Public
2M runs
A100 (80GB)
GitHub
Paper
License

Iterate in playground

Run with an API

Playground API Examples README Versions

Input

main_face_image

*file

Upload an ID image for face generation

prompt

string

Shift + Return to add a new line

a woman holding sign with glowing green text "PuLID for FLUX"a woman holding sign with glowing green text "PuLID for FLUX"

Enter a text prompt to guide image generation

Default: "portrait, color, cinematic"

width

integer

(minimum: 256, maximum: 1536)

Set the width of the generated image (256-1536 pixels)

Default: 896

height

integer

(minimum: 256, maximum: 1536)

Set the height of the generated image (256-1536 pixels)

Default: 1152

num_steps

integer

(minimum: 1, maximum: 20)

Set the number of denoising steps (1-20)

Default: 20

start_step

integer

(minimum: 0, maximum: 10)

Set the timestep to start inserting ID (0-4 recommended, 0 for highest fidelity, 4 for more editability)

Default: 0

guidance_scale

number

(minimum: 1, maximum: 10)

Set the guidance scale for text prompt influence (1.0-10.0)

Default: 4

id_weight

number

(minimum: 0, maximum: 3)

Set the weight of the ID image influence (0.0-3.0)

Default: 1

num_outputs

integer

(minimum: 1, maximum: 4)

Set the number of images to generate (1-4)

Default: 1

Including negative_prompt and 5 more...

negative_prompt

string

Shift + Return to add a new line

bad quality, worst quality, text, signature, watermark, extra limbsbad quality, worst quality, text, signature, watermark, extra limbs

Enter a negative prompt to specify what to avoid in the image

Default: "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"

seed

integer

Set a random seed for generation (leave blank or -1 for random)

true_cfg

number

(minimum: 1, maximum: 10)

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.

Default: 1

max_sequence_length

integer

(minimum: 128, maximum: 512)

Set the max sequence length for prompt (T5), smaller is faster (128-512)

Default: 128

output_format

string

Choose the format of the output image

Default: "webp"

output_quality

integer

(minimum: 1, maximum: 100)

Set the quality of the output image for jpg and webp (1-100)

Default: 80

Run this model in Node.js with one line of code:

npx create-replicate --model=bytedance/flux-pulid

or set up a project from scratch

Install Replicate’s Node.js client library:

npm install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import and set up the client:

import Replicate from "replicate";
import fs from "node:fs";

const replicate = new Replicate({
  auth: process.env.REPLICATE_API_TOKEN,
});

Run bytedance/flux-pulid using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

const output = await replicate.run(
  "bytedance/flux-pulid:8baa7ef2255075b46f4d91cd238c21d31181b3e6a864463f967960bb0112525b",
  {
    input: {
      width: 896,
      height: 1152,
      prompt: "a woman holding sign with glowing green text \"PuLID for FLUX\"",
      true_cfg: 1,
      id_weight: 1,
      num_steps: 20,
      start_step: 4,
      num_outputs: 4,
      output_format: "webp",
      guidance_scale: 4,
      output_quality: 80,
      main_face_image: "https://replicate.delivery/pbxt/MayZhLThspqLqRhirB8VEjqbEX5B0PWqjd9xe3PkTv2wLMcr/woman.png",
      negative_prompt: "bad quality, worst quality, text, signature, watermark, extra limbs",
      max_sequence_length: 128
    }
  }
);

// To access the file URL:
console.log(output[0].url()); //=> "http://example.com"

// To write the file to disk:
fs.writeFile("my-image.png", output[0]);

To learn more, take a look at the guide on getting started with Node.js.

Install Replicate’s Python client library:

pip install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import the client:

import replicate

Run bytedance/flux-pulid using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

output = replicate.run(
    "bytedance/flux-pulid:8baa7ef2255075b46f4d91cd238c21d31181b3e6a864463f967960bb0112525b",
    input={
        "width": 896,
        "height": 1152,
        "prompt": "a woman holding sign with glowing green text \"PuLID for FLUX\"",
        "true_cfg": 1,
        "id_weight": 1,
        "num_steps": 20,
        "start_step": 4,
        "num_outputs": 4,
        "output_format": "webp",
        "guidance_scale": 4,
        "output_quality": 80,
        "main_face_image": "https://replicate.delivery/pbxt/MayZhLThspqLqRhirB8VEjqbEX5B0PWqjd9xe3PkTv2wLMcr/woman.png",
        "negative_prompt": "bad quality, worst quality, text, signature, watermark, extra limbs",
        "max_sequence_length": 128
    }
)
print(output)

To learn more, take a look at the guide on getting started with Python.

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Run bytedance/flux-pulid using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

curl -s -X POST \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Prefer: wait" \
  -d $'{
    "version": "bytedance/flux-pulid:8baa7ef2255075b46f4d91cd238c21d31181b3e6a864463f967960bb0112525b",
    "input": {
      "width": 896,
      "height": 1152,
      "prompt": "a woman holding sign with glowing green text \\"PuLID for FLUX\\"",
      "true_cfg": 1,
      "id_weight": 1,
      "num_steps": 20,
      "start_step": 4,
      "num_outputs": 4,
      "output_format": "webp",
      "guidance_scale": 4,
      "output_quality": 80,
      "main_face_image": "https://replicate.delivery/pbxt/MayZhLThspqLqRhirB8VEjqbEX5B0PWqjd9xe3PkTv2wLMcr/woman.png",
      "negative_prompt": "bad quality, worst quality, text, signature, watermark, extra limbs",
      "max_sequence_length": 128
    }
  }' \
  https://api.replicate.com/v1/predictions

To learn more, take a look at Replicate’s HTTP API reference docs.

Output

{
  "completed_at": "2025-03-03T14:30:03.900633Z",
  "created_at": "2025-03-03T14:29:01.621000Z",
  "data_removed": false,
  "error": null,
  "id": "zm4dca866nrj20cnbhmsy5bzbr",
  "input": {
    "width": 896,
    "height": 1152,
    "prompt": "a woman holding sign with glowing green text \"PuLID for FLUX\"",
    "true_cfg": 1,
    "id_weight": 1,
    "num_steps": 20,
    "start_step": 4,
    "num_outputs": 4,
    "output_format": "webp",
    "guidance_scale": 4,
    "output_quality": 80,
    "main_face_image": "https://replicate.delivery/pbxt/MayZhLThspqLqRhirB8VEjqbEX5B0PWqjd9xe3PkTv2wLMcr/woman.png",
    "negative_prompt": "bad quality, worst quality, text, signature, watermark, extra limbs",
    "max_sequence_length": 128
  },
  "logs": "Using seeds: [3902735353, 3906845023, 3960091009, 3285723470]\nGenerating 'a woman holding sign with glowing green text \"PuLID for FLUX\"' with seeds [3902735353, 3906845023, 3960091009, 3285723470]\nDenoising time: 32.90 seconds\nDecoding time: 0.69 seconds\nTotal generate_image time: 39.42 seconds\nImage 1 generated with seed: 3902735353\nImage 2 generated with seed: 3906845023\nImage 3 generated with seed: 3960091009\nImage 4 generated with seed: 3285723470\nTotal prediction time: 39.72 seconds",
  "metrics": {
    "predict_time": 40.05908108,
    "total_time": 62.279633
  },
  "output": [
    "https://replicate.delivery/yhqm/QVmFonkKOW6BGFpwXs0IBBPej7dQIAraR4qcN7RUTQ31dbKKA/output_1.webp",
    "https://replicate.delivery/yhqm/3KwUWUho1ZYlE9b7NfWW01O1QGz35ySyuJIcawIyM2h1dbKKA/output_2.webp",
    "https://replicate.delivery/yhqm/vZdySqlit06dENDmsSax5TYSlqIMEGOMDQZmKrwLfTg1dbKKA/output_3.webp",
    "https://replicate.delivery/yhqm/SuPGFeAD4gysaqUOtFaIdrqqwJFhfafAtxqsjTVVpKYW3tpoA/output_4.webp"
  ],
  "started_at": "2025-03-03T14:29:23.841552Z",
  "status": "succeeded",
  "urls": {
    "stream": "https://stream.replicate.com/v1/files/yswh-3kvtmf7hllngrtvsj3qjepsxynwdwzsejzodqdzpioojmtci3i2a",
    "get": "https://api.replicate.com/v1/predictions/zm4dca866nrj20cnbhmsy5bzbr",
    "cancel": "https://api.replicate.com/v1/predictions/zm4dca866nrj20cnbhmsy5bzbr/cancel"
  },
  "version": "8baa7ef2255075b46f4d91cd238c21d31181b3e6a864463f967960bb0112525b"
}

Generated in

40.1 seconds

Tweak it ShareReport View full prediction

Examples

View more examples

Run time and cost

This model costs approximately $0.028 to run on Replicate, or 35 runs per $1, but this varies depending on your inputs. It is also open source and you can run it on your own computer with Docker.

This model runs on Nvidia A100 (80GB) GPU hardware. Predictions typically complete within 21 seconds.

Readme

PuLID for FLUX

Welcome to PuLID-FLUX-v0.9.0, a tuning-free ID customization solution for FLUX.1-dev.

🆕 Looking for the classic PuLID for Stable Diffusion XL? Check out our Classic PuLID demo!

About PuLID for FLUX

PuLID (Pure and Lightning ID customization) is an AI model that customizes images, especially faces, while keeping important identity features. This version is specifically optimized for FLUX.1-dev. Here’s what PuLID for FLUX does:

It adds a specific identity (like a person’s face) to the FLUX.1-dev text-to-image model without changing how the model usually works.
It creates images with high identity similarity.
It lets you change things like attributes, styles, and backgrounds using text prompts.
It keeps image elements like background, lighting, and style consistent.
It gives you lots of options to edit and change the generated images.

PuLID for FLUX uses some cool tech stuff: - It has two main parts: a regular diffusion training part and a new Lightning T2I part. - It uses special ways to understand facial identity. - It uses a technique called “contrastive alignment” to keep images consistent. - It can create images quickly while still getting the identity right.

You can use PuLID for FLUX for things like: - Making avatars and characters - Editing and improving faces - Creating digital art - Making prototypes and visualizations

How to Use This Replicate Demo

Upload an image with the identity you want to use.
Write a prompt describing the image you want to create.
Adjust the settings if you need to (check out the “Useful Tips” below).
Click to generate your customized image!

Useful Tips

Two important settings to think about:

Timestep to start inserting ID:
This decides when to start adding the identity during image creation.
Lower numbers (0-1) make the identity look more similar but might be harder to edit.
Higher numbers (like 4) are easier to edit but might make the identity less similar.
We suggest using 4 for realistic images, and 0-1 for stylized images.
True CFG scale:
FLUX.1-dev uses something called a “fake CFG” usually.
You can choose to use either fake CFG or true CFG.
Fake CFG often works well for realistic-looking scenes.
True CFG might make the identity look more similar in some cases.
Try true CFG for stylized scenes if the identity doesn’t look similar enough or the style isn’t quite right.

Limitations

This is a test version. We’ve noticed that it might not work as well for some male faces. We’re working on making it better, so check back for updates!

Examples

Here are some examples generated with PuLID-FLUX:

PuLID-FLUX Examples

Learn More

For more technical details, latest updates, and additional examples, visit our GitHub repository.

If PuLID-FLUX is helpful, please star our repo or tell your friends about it!

Questions or Suggestions?

If you have questions or ideas, please open an issue on our GitHub repository.

Citation

If you use PuLID in your work, please cite:

@article{guo2024pulid,
  title={PuLID: Pure and Lightning ID Customization via Contrastive Alignment},
  author={Guo, Zinan and Wu, Yanze and Chen, Zhuowei and Chen, Lang and He, Qian},
  journal={arXiv preprint arXiv:2404.16022},
  year={2024}
}

Support

For updates and more AI content, follow: - The lead developers: - Yanze Wu: GitHub - Zinan Guo: Email