POST
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 import requests import base64 # Use this function to convert an image file from the filesystem to base64 def image_file_to_base64(image_path): with open(image_path, 'rb') as f: image_data = f.read() return base64.b64encode(image_data).decode('utf-8') # Use this function to fetch an image from a URL and convert it to base64 def image_url_to_base64(image_url): response = requests.get(image_url) image_data = response.content return base64.b64encode(image_data).decode('utf-8') api_key = "YOUR_API_KEY" url = "https://api.segmind.com/v1/sd1.5-controlnet-depth" # Request payload data = { "image": image_url_to_base64("https://segmind.com/depth.jpeg"), # Or use image_file_to_base64("IMAGE_PATH") "samples": 1, "prompt": "young african american man, black suit, smiling, white background", "negative_prompt": "mangled ears, Disfigured, cartoon, blurry, nude", "scheduler": "UniPC", "num_inference_steps": 25, "guidance_scale": 7.5, "strength": 1, "seed": 9715432854, "base64": False } headers = {'x-api-key': api_key} response = requests.post(url, json=data, headers=headers) print(response.content) # The response is the generated image
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

Attributes


imageimage *

Input Image


samplesint ( default: 1 ) Affects Pricing

Number of samples to generate.

min : 1,

max : 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,

max : 100


guidance_scalefloat ( default: 7.5 )

Scale for classifier-free guidance

min : 0.1,

max : 25


strengthfloat ( default: 1 )

How much to transform the reference image

min : 0.1,

max : 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 Depth

ControlNet Depth is a neural network that can be used to control the output of Stable Diffusion models with depth information. This allows you to specify specific features that you want to include in the output image, such as the overall structure of the image, the pose of the subject, or the style of the image, as well as the depth information.

To use ControlNet Depth, you can follow these steps:

  1. Go to the Segmind website: https://www.segmind.com/ and sign up for a free account.

  2. Click on the "Models" tab and select "ControlNet Depth".

  3. Click on the "Try it out" button and upload an image that you want to control.

  4. Click on the "Generate" button to generate the controlled image.

ControlNet Depth is a powerful tool that can be used for various purposes. It is still under development, but it has the potential to revolutionize the way we interact with images. Reach out to us to learn more about how we can help you with customized solutions, large-scale cost-effective deployment, and other use cases.

Applications/Use Cases

  1. Creating images with specific features: ControlNet Depth can be used to create images with specific features, such as a particular pose, a specific style, or a specific object, as well as depth information. This can be useful for creating images for creative projects or for research purposes.

  2. Improving the quality of images: ControlNet Depth can be used to improve the quality of images by removing noise or by adding detail. This can be useful for restoring damaged images or creating more realistic ones.

  3. Controlling the output of Stable Diffusion models with depth information: ControlNet Depth can be used to control the output of Stable Diffusion models to include specific features, as well as depth information. This can be useful for creating images with a particular style or for creating images consistent with a particular dataset.