jichengdu/flux-pulid:ca0b96aa – Run with an API on Replicate

Version

You're looking at a specific version of this model. Jump to the model overview.

jichengdu /flux-pulid:ca0b96aa

Playground API Setup logs

Input

main_face_image

*file

Upload an ID image for face generation

prompt

string

Shift + Return to add a new line

Enter a text prompt to guide image generation

Default: "portrait, color, cinematic"

negative_prompt

string

Shift + Return to add a new line

bad quality, worst quality, text, signature, watermark, extra limbs, low resolution, partially rendered objects, deformed or partially rendered eyes, deformed, deformed eyeballs, cross-eyed, blurrybad quality, worst quality, text, signature, watermark, extra limbs, low resolution, partially rendered objects, deformed or partially rendered eyes, deformed, deformed eyeballs, cross-eyed, blurry

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"

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

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

num_outputs

integer

(minimum: 1, maximum: 4)

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

Default: 1

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

npx create-replicate --model=jichengdu/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";

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

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

const output = await replicate.run(
  "jichengdu/flux-pulid:ca0b96aa9f0d0a0a7962a727377806215df25a517865e5f6949f24a26c24d2a6",
  {
    input: {
      width: 896,
      height: 1152,
      prompt: "portrait, color, cinematic",
      true_cfg: 1,
      id_weight: 1,
      num_steps: 20,
      start_step: 0,
      num_outputs: 1,
      output_format: "webp",
      guidance_scale: 4,
      output_quality: 80,
      negative_prompt: "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",
      max_sequence_length: 128
    }
  }
);
console.log(output);

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 jichengdu/flux-pulid using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

output = replicate.run(
    "jichengdu/flux-pulid:ca0b96aa9f0d0a0a7962a727377806215df25a517865e5f6949f24a26c24d2a6",
    input={
        "width": 896,
        "height": 1152,
        "prompt": "portrait, color, cinematic",
        "true_cfg": 1,
        "id_weight": 1,
        "num_steps": 20,
        "start_step": 0,
        "num_outputs": 1,
        "output_format": "webp",
        "guidance_scale": 4,
        "output_quality": 80,
        "negative_prompt": "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",
        "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 jichengdu/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": "ca0b96aa9f0d0a0a7962a727377806215df25a517865e5f6949f24a26c24d2a6",
    "input": {
      "width": 896,
      "height": 1152,
      "prompt": "portrait, color, cinematic",
      "true_cfg": 1,
      "id_weight": 1,
      "num_steps": 20,
      "start_step": 0,
      "num_outputs": 1,
      "output_format": "webp",
      "guidance_scale": 4,
      "output_quality": 80,
      "negative_prompt": "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",
      "max_sequence_length": 128
    }
  }' \
  https://api.replicate.com/v1/predictions

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

Install Cog

brew install cog

If you don’t have Homebrew, there are other installation options available.

Pull and run jichengdu/flux-pulid using Cog (this will download the full model and run it in your local environment):

cog predict r8.im/jichengdu/flux-pulid@sha256:ca0b96aa9f0d0a0a7962a727377806215df25a517865e5f6949f24a26c24d2a6 \
  -i 'width=896' \
  -i 'height=1152' \
  -i 'prompt="portrait, color, cinematic"' \
  -i 'true_cfg=1' \
  -i 'id_weight=1' \
  -i 'num_steps=20' \
  -i 'start_step=0' \
  -i 'num_outputs=1' \
  -i 'output_format="webp"' \
  -i 'guidance_scale=4' \
  -i 'output_quality=80' \
  -i 'negative_prompt="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"' \
  -i 'max_sequence_length=128'

To learn more, take a look at the Cog documentation.

Pull and run jichengdu/flux-pulid using Docker (this will download the full model and run it in your local environment):

docker run -d -p 5000:5000 --gpus=all r8.im/jichengdu/flux-pulid@sha256:ca0b96aa9f0d0a0a7962a727377806215df25a517865e5f6949f24a26c24d2a6
curl -s -X POST \
  -H "Content-Type: application/json" \
  -d $'{
    "input": {
      "width": 896,
      "height": 1152,
      "prompt": "portrait, color, cinematic",
      "true_cfg": 1,
      "id_weight": 1,
      "num_steps": 20,
      "start_step": 0,
      "num_outputs": 1,
      "output_format": "webp",
      "guidance_scale": 4,
      "output_quality": 80,
      "negative_prompt": "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",
      "max_sequence_length": 128
    }
  }' \
  http://localhost:5000/predictions

Output

No output yet! Press "Submit" to start a prediction.