Generate ControlNet SD1.5

post

https://image.octoai.run/generate/controlnet-sd15

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Generate one or more images based on the given parameters.

prompt

string

required

length ≤ 10000

Text describing the image content to generate.

prompt_2

length ≤ 10000

Text with a high-level description of the image to generate. Used only by SD XL.

negative_prompt

length ≤ 10000

Text describing image traits to avoid during generation.

negative_prompt_2

length ≤ 10000

Text with a high level description of things to avoid during generation. Used only by SD XL.

checkpoint

Custom checkpoint to be used during image generation.

controlnet

ControlNet to be used during image generation

vae

Custom VAE to be used during image generation.

textual_inversions

object | null

A dictionary of textual inversions to be used during image generation. Textual inversions as keys and trigger words as values.

loras

object | null

A dictionary of LoRAs to apply. LoRAs as keys and their weights (float) as values.

sampler

string

enum

Defaults to DDIM

The schedulers available for image generation.

height

Integer representing the height of image to generate. None will default to 512 for SD 1.5 and 1024 for SD XL and SSD. Supported resolutions (w,h): SDXL={(1536, 640), (768, 1344), (832, 1216), (1344, 768), (1152, 896), (640, 1536), (1216, 832), (896, 1152), (1024, 1024)}, SD1.5={(768, 576), (1024, 576), (640, 512), (384, 704), (640, 768), (640, 640), (1024, 768), (1536, 1024), (768, 1024), (576, 448), (1024, 1024), (896, 896), (704, 1216), (512, 512), (448, 576), (832, 512), (512, 704), (576, 768), (1216, 704), (512, 768), (512, 832), (1024, 1536), (576, 1024), (704, 384), (768, 512)}, SSD={(1536, 640), (768, 1344), (832, 1216), (1344, 768), (1152, 896), (640, 1536), (1216, 832), (896, 1152), (1024, 1024)}

width

Integer representing the width of image to generate. None will default to 512 for SD 1.5 and 1024 for SD XL and SSD. Supported resolutions (w,h): SDXL={(1536, 640), (768, 1344), (832, 1216), (1344, 768), (1152, 896), (640, 1536), (1216, 832), (896, 1152), (1024, 1024)}, SD1.5={(768, 576), (1024, 576), (640, 512), (384, 704), (640, 768), (640, 640), (1024, 768), (1536, 1024), (768, 1024), (576, 448), (1024, 1024), (896, 896), (704, 1216), (512, 512), (448, 576), (832, 512), (512, 704), (576, 768), (1216, 704), (512, 768), (512, 832), (1024, 1536), (576, 1024), (704, 384), (768, 512)}, SSD={(1536, 640), (768, 1344), (832, 1216), (1344, 768), (1152, 896), (640, 1536), (1216, 832), (896, 1152), (1024, 1024)}

cfg_scale

number

≤ 50

Defaults to 12

Floating-point number represeting how closely to adhere to prompt description. Must be a positive number no greater than 50.0.

steps

integer

0 to 200

Defaults to 30

Integer repreenting how many steps of diffusion to run. Must be greater than 0 and less than or equal to 200.

num_images

integer

0 to 16

Defaults to 1

Integer representing how many output images to generate with a single prompt/configuration.

seed

integer | array | null

Integer number or list of integers representing the seeds of random generators. Fixing random seed is useful when attempting to generate a specific image. Must be greater than 0 and less than 2^32.

controlnet_image

Controlnet image encoded in b64 string for guiding image generation. Required for controlnet engines.

init_image

Starting point image encoded in b64 string for Image to Image generation mode.

mask_image

b64 encoded mask image for inpainting. White area should indicate where to paint.

strength

number

0 to 1

Defaults to 0.8

Floating-point number indicating how much creative the Image to Image generation mode should be. Must be greater than 0 and less than or equal to 1.0.

style_preset

SDXLStyles | null

Pre-defined styles used to guide the output image towards a particular style. Pre-defined styles are only supported by SDXL.

use_refiner

boolean

Defaults to true

Whether to enable and apply the SDXL refiner model to the image generation.

high_noise_frac

number

0 to 1

Defaults to 0.8

Floating-point number that defines the fraction of steps to perform with the base model. Used only by SD XL. Must be greater than or equal to 0.0 and less than or equal to 1.0.

controlnet_conditioning_scale

number

Defaults to 1

How strong the effect of the controlnet should be.

controlnet_preprocess

boolean

Defaults to true

Whether to apply automatic ControlNet preprocessing.

clip_skip

Optionally skip later layers of the text encoder. Higher values lead to more abstract interpretations of the prompt.

image_encoding

string

enum

Defaults to jpeg

The image encoding types available for image generation response.

Allowed:

Responses

200Successful Response

422Validation Error