mgonline2021/ctrlxl:23761eef – Run with an API on Replicate

Version

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

mgonline2021 /ctrlxl:23761eef

Playground API

Input

control_image

file

Optional Image to use for guidance based on canny

image

file

Optional Image to use for img2img guidance

mask

file

Optional Mask to use for legacy inpainting

prompt

string

Shift + Return to add a new line

Input prompt

Default: "photo of cjw person"

negative_prompt

string

Shift + Return to add a new line

Specify things to not see in the output

width

integer

Width of output image. Maximum size is 1024x768 or 768x1024 because of memory limits

Default: 512

height

integer

Height of output image. Maximum size is 1024x768 or 768x1024 because of memory limits

Default: 512

num_outputs

integer

(minimum: 1, maximum: 10)

Number of images to output.

Default: 1

num_inference_steps

integer

(minimum: 1, maximum: 500)

Number of denoising steps

Default: 50

guidance_scale

number

(minimum: 1, maximum: 20)

Scale for classifier-free guidance

Default: 7.5

prompt_strength

number

Prompt strength when using init image. 1.0 corresponds to full destruction of information in init image

Default: 0.8

low_threshold

integer

Low threshold for canny filter

Default: 100

high_threshold

integer

High threshold for canny filter

Default: 200

scheduler

string

Choose a scheduler.

Default: "DPMSolverMultistep"

disable_safety_check

boolean

Disable safety check. Use at your own risk!

Default: false

return_processed_control

boolean

if using control_image, return processed control as first image

Default: false

seed

integer

Random seed. Leave blank to randomize the seed

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

npx create-replicate --model=mgonline2021/ctrlxl

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

const output = await replicate.run(
  "mgonline2021/ctrlxl:23761eefe15098c6f5b24e2fa2f7bbd32e8e292a1711e547df9dde94a33ade8a",
  {
    input: {
      width: 512,
      height: 512,
      prompt: "photo of cjw person",
      scheduler: "DPMSolverMultistep",
      num_outputs: 1,
      low_threshold: 100,
      guidance_scale: 7.5,
      high_threshold: 200,
      prompt_strength: 0.8,
      num_inference_steps: 50,
      disable_safety_check: false,
      return_processed_control: 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 mgonline2021/ctrlxl using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

output = replicate.run(
    "mgonline2021/ctrlxl:23761eefe15098c6f5b24e2fa2f7bbd32e8e292a1711e547df9dde94a33ade8a",
    input={
        "width": 512,
        "height": 512,
        "prompt": "photo of cjw person",
        "scheduler": "DPMSolverMultistep",
        "num_outputs": 1,
        "low_threshold": 100,
        "guidance_scale": 7.5,
        "high_threshold": 200,
        "prompt_strength": 0.8,
        "num_inference_steps": 50,
        "disable_safety_check": False,
        "return_processed_control": False
    }
)

# The mgonline2021/ctrlxl model can stream output as it's running.
# The predict method returns an iterator, and you can iterate over that output.
for item in output:
    # https://replicate.com/mgonline2021/ctrlxl/api#output-schema
    print(item)

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 mgonline2021/ctrlxl 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": "mgonline2021/ctrlxl:23761eefe15098c6f5b24e2fa2f7bbd32e8e292a1711e547df9dde94a33ade8a",
    "input": {
      "width": 512,
      "height": 512,
      "prompt": "photo of cjw person",
      "scheduler": "DPMSolverMultistep",
      "num_outputs": 1,
      "low_threshold": 100,
      "guidance_scale": 7.5,
      "high_threshold": 200,
      "prompt_strength": 0.8,
      "num_inference_steps": 50,
      "disable_safety_check": false,
      "return_processed_control": 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.