mattheum/flux-multi-pulid-controlnet:773c36c0 – 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:773c36c0

Playground API

Input

left_face_image

*file

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

right_face_image

*file

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

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=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:773c36c0ba19303547c5c183c46cdf2847fb048f76a8cbcfd347197a2f7620fa",
  {
    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
    }
  }
);

// 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:773c36c0ba19303547c5c183c46cdf2847fb048f76a8cbcfd347197a2f7620fa",
    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 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": "773c36c0ba19303547c5c183c46cdf2847fb048f76a8cbcfd347197a2f7620fa",
    "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.

Output

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