POST/v1/sd1.5-controlnet-canny
1const axios = require('axios');
2
3const fs = require('fs');
4const path = require('path');
5
6async function toB64(imgPath) {
7    const data = fs.readFileSync(path.resolve(imgPath));
8    return Buffer.from(data).toString('base64');
9}
10
11const api_key = "YOUR API-KEY";
12const url = "https://api.segmind.com/v1/sd1.5-controlnet-canny";
13
14const data = {
15  "image": "toB64('https://segmind.com/canny-input.jpeg')",
16  "samples": 1,
17  "prompt": "a colorful bird, 4k",
18  "negative_prompt": "Disfigured, cartoon, blurry, nude",
19  "scheduler": "UniPC",
20  "num_inference_steps": 25,
21  "guidance_scale": 7.5,
22  "strength": 1,
23  "seed": 3131738736286,
24  "base64": false
25};
26
27(async function() {
28    try {
29        const response = await axios.post(url, data, { headers: { 'x-api-key': api_key } });
30        console.log(response.data);
31    } catch (error) {
32        console.error('Error:', error.response.data);
33    }
34})();
RESPONSE
image/jpeg
HTTP Response Codes
200 - OKImage Generated
401 - UnauthorizedUser authentication failed
404 - Not FoundThe requested URL does not exist
405 - Method Not AllowedThe requested HTTP method is not allowed
406 - Not AcceptableNot enough credits
500 - Server ErrorServer had some issue with processing
Expand

Attributes

imageimage *

Input Image

samplesint ( default: 1 ) Affects Pricing

Number of samples to generate.

min : 1,

min : 4

promptstr *

Prompt to render

negative_promptstr ( default: None )

Prompts to exclude, eg. 'bad anatomy, bad hands, missing fingers'

schedulerenum:str ( default: UniPC )

Type of scheduler.

Allowed values:

num_inference_stepsint ( default: 20 ) Affects Pricing

Number of denoising steps.

min : 20,

min : 100

guidance_scalefloat ( default: 7.5 )

Scale for classifier-free guidance

min : 0.1,

min : 25

strengthfloat ( default: 1 )

How much to transform the reference image

min : 0.1,

min : 1

seedint ( default: -1 )

Seed for image generation.

base64boolean ( default: 1 )

Base64 encoding of the output image.

To keep track of your credit usage, you can inspect the response headers of each API call. The x-remaining-credits property will indicate the number of remaining credits in your account. Ensure you monitor this value to avoid any disruptions in your API usage.

ControlNet Canny

This cutting-edge model transcends traditional boundaries by employing the sophisticated canny edge detection method. Canny edge detection operates by pinpointing edges in an image through the identification of sudden shifts in intensity. Renowned for its prowess in accurately detecting edges while minimizing noise and erroneous edges, the method becomes even more potent when the preprocessor enhances its discernment by lowering the thresholds. Granting users an extraordinary level of control over image transformation parameters, the ControlNet Canny model is revolutionizing image editing and computer vision tasks, providing a customizable experience that caters to both subtle and dramatic image enhancements.

At the core of the ControlNet Canny model lies the renowned canny edge detection mechanism. This image-to-image transformation model is meticulously crafted to detect and emphasize edges in images. Its design allows users to tweak and adjust parameters, ensuring that the edge detection is tailored to specific needs, be it subtle enhancements or bold transformations.

Advantages

  1. Precision Edge Detection: Utilizes the canny edge detection technique, known for its accuracy in identifying image edges.

  2. User Control: Offers users the ability to fine-tune parameters, ensuring customized edge enhancements.

  3. Versatility: Suitable for a myriad of applications, from artistic effects to technical image processing tasks.

  4. Real-time Manipulation: Allows for instantaneous adjustments, providing users with real-time feedback and results.

##Use Cases

  1. Image Segmentation: Ideal for tasks where precise edge identification is paramount, ensuring accurate segmentation.

  2. Image Enhancement: Users can emphasize and highlight specific edges, enhancing the overall image quality and focus.

  3. Artistic Effects: Artists and designers can leverage the model to create unique visual effects by manipulating image edges.

  4. Advanced Image Editing Software: Can be integrated as a feature, offering users advanced edge manipulation capabilities.

  5. Computer Vision Tasks: Perfect for algorithms that require accurate edge detection for object recognition or feature extraction.

ControlNet Canny License

ControlNet Canny, in its commitment to ethical AI practices, has embraced the CreativeML OpenRAIL M license. This decision not only underscores the model's dedication to responsible AI but also aligns it with the principles set forth by BigScience and the RAIL Initiative. Their collaborative work in AI ethics and responsibility has set the benchmark for licenses like the OpenRAIL M.