mattheum/flux-multi-pulid-controlnet:670d7a06 – Run with an API on Replicate

Version

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

mattheum /flux-multi-pulid-controlnet:670d7a06

Playground API

Input

id_one_image

*file

Upload an ID image for the left side of the generated image

id_two_image

file

Upload an ID image for the right side of the generated image

id_three_image

file

Upload an ID image for the left side of the generated image

id_four_image

file

Upload an ID image for the right side of the generated image

mask_one_image

file

Upload an mask image for the first person of the generated image

mask_two_image

file

Upload an mask image for the second person of the generated image

mask_three_image

file

Upload an mask image for the third person of the generated image

mask_four_image

file

Upload an mask image for the fourth person of the generated image

img_to_img_image

file

Upload an image to guide the generation

image2image_strength

number

(minimum: 0, maximum: 1)

Set the strength of the image to image guidance (0.0-1.0)

Default: 0

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: 1024

height

integer

(minimum: 256, maximum: 1536)

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

Default: 1024

num_steps

integer

(minimum: 1, maximum: 25)

Set the number of denoising steps (1-20)

Default: 25

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

use_canny_controlnet

boolean

Use the Canny controlnet

Default: false

use_depth_controlnet

boolean

Use the Depth controlnet

Default: false

control_net_image

file

Upload an image to guide the generation

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

npx create-replicate --model=mattheum/flux-multi-pulid-controlnet

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

const output = await replicate.run(
  "mattheum/flux-multi-pulid-controlnet:670d7a06e40f300beeb3eb49e427643586e417fd2c5a356ab8eb1f335d3f7f5e",
  {
    input: {
      width: 1024,
      height: 1024,
      prompt: "portrait, color, cinematic",
      true_cfg: 1,
      id_weight: 1,
      num_steps: 25,
      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,
      image2image_strength: 0,
      use_canny_controlnet: false,
      use_depth_controlnet: false
    }
  }
);

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

output = replicate.run(
    "mattheum/flux-multi-pulid-controlnet:670d7a06e40f300beeb3eb49e427643586e417fd2c5a356ab8eb1f335d3f7f5e",
    input={
        "width": 1024,
        "height": 1024,
        "prompt": "portrait, color, cinematic",
        "true_cfg": 1,
        "id_weight": 1,
        "num_steps": 25,
        "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,
        "image2image_strength": 0,
        "use_canny_controlnet": False,
        "use_depth_controlnet": False
    }
)
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 mattheum/flux-multi-pulid-controlnet 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": "mattheum/flux-multi-pulid-controlnet:670d7a06e40f300beeb3eb49e427643586e417fd2c5a356ab8eb1f335d3f7f5e",
    "input": {
      "width": 1024,
      "height": 1024,
      "prompt": "portrait, color, cinematic",
      "true_cfg": 1,
      "id_weight": 1,
      "num_steps": 25,
      "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,
      "image2image_strength": 0,
      "use_canny_controlnet": false,
      "use_depth_controlnet": false
    }
  }' \
  https://api.replicate.com/v1/predictions

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

Output

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