zsxkib/sd3-controlnet:1512680a | Run with an API on Replicate

Version

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

zsxkib /sd3-controlnet:1512680a

Playground API

Input

input_image

*file

Input image

prompt

*string

Shift + Return to add a new line

Prompt

negative_prompt

string

Shift + Return to add a new line

Negative prompt

Default: "NSFW, nude, naked, porn, ugly"

structure

string

Structure type

Default: "canny"

aspect_ratio

string

Aspect ratio for the generated image. Note that the model performs best at 1024x1024 resolution. Other sizes may yield suboptimal results.

Default: "1:1"

num_outputs

integer

(minimum: 1, maximum: 4)

Number of images to output.

Default: 1

inference_steps

integer

(minimum: 1, maximum: 50)

Inference steps

Default: 25

guidance_scale

number

(minimum: 0, maximum: 50)

Guidance scale

Default: 7

control_weight

number

(minimum: 0, maximum: 1)

Control weight

Default: 0.7

low_threshold

integer

(minimum: 1, maximum: 255)

[Canny only] Line detection low threshold

Default: 100

high_threshold

integer

(minimum: 1, maximum: 255)

[Canny only] Line detection high threshold

Default: 200

seed

integer

Random seed. Leave blank to randomize the seed

output_format

string

Format of the output images

Default: "webp"

output_quality

integer

(minimum: 0, maximum: 100)

Quality of the output images, from 0 to 100. 100 is best quality, 0 is lowest quality.

Default: 80

disable_safety_checker

boolean

Disable safety checker for generated images. This feature is only available through the API. See [https://replicate.com/docs/how-does-replicate-work#safety](https://replicate.com/docs/how-does-replicate-work#safety)

Default: false

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

npx create-replicate --model=zsxkib/sd3-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";
import fs from "node:fs";

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

Run zsxkib/sd3-controlnet using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

const output = await replicate.run(
  "zsxkib/sd3-controlnet:1512680a528ba127ad49e92e36780974e5aa12c7d717af83c4a98a9253adf2c6",
  {
    input: {
      structure: "canny",
      num_outputs: 1,
      aspect_ratio: "1:1",
      low_threshold: 100,
      output_format: "webp",
      control_weight: 0.7,
      guidance_scale: 7,
      high_threshold: 200,
      output_quality: 80,
      inference_steps: 25,
      negative_prompt: "NSFW, nude, naked, porn, ugly"
    }
  }
);

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

output = replicate.run(
    "zsxkib/sd3-controlnet:1512680a528ba127ad49e92e36780974e5aa12c7d717af83c4a98a9253adf2c6",
    input={
        "structure": "canny",
        "num_outputs": 1,
        "aspect_ratio": "1:1",
        "low_threshold": 100,
        "output_format": "webp",
        "control_weight": 0.7,
        "guidance_scale": 7,
        "high_threshold": 200,
        "output_quality": 80,
        "inference_steps": 25,
        "negative_prompt": "NSFW, nude, naked, porn, ugly"
    }
)

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

# To write the file to disk:
with open("my-image.png", "wb") as file:
    file.write(output[0].read())

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 zsxkib/sd3-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": "zsxkib/sd3-controlnet:1512680a528ba127ad49e92e36780974e5aa12c7d717af83c4a98a9253adf2c6",
    "input": {
      "structure": "canny",
      "num_outputs": 1,
      "aspect_ratio": "1:1",
      "low_threshold": 100,
      "output_format": "webp",
      "control_weight": 0.7,
      "guidance_scale": 7,
      "high_threshold": 200,
      "output_quality": 80,
      "inference_steps": 25,
      "negative_prompt": "NSFW, nude, naked, porn, ugly"
    }
  }' \
  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.