Skip to main content
curl --location "https://randomseed.lol/v1/controlnet" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer $RANDOMSEED_API_KEY" \
  --data '{
      "controlnet": {
          "prompt": "Beautiful landscape with fluffy clouds, HDR lighting, high dynamic range, vibrant colors",
          "negative_prompt": "((deformed face)), ((disfigured)), ((bad art)), ((deformed)), (disfigured face and eyes:1.1)",
          "width": "1028",
          "height": "512",
          "number_of_images": "4",
          "steps": "20",
          "cfg_scale": 8,
          "sampler_name": "Euler a",
          "model_name": "realistic_vision_v4",
          "controlnet_args": [
              {
                  "input_image": "...",
                  "module": null,
                  "model": "control_v1p_sd15_qrcode_monster"
              }
          ],
          "webhook": "...",
          "track_id": 1,
          "seed": "-1"
      }
  }'

{
    "message": "image generation in progress",
    "result": {
      "id": "...", // request id you're going to use for polling if webhook url is not provided
      "status": "IN_QUEUE"
    }
}

​
API key

Create your account on RandomSeed & grab your api key

​
Headers

​
Authorization
string
Your API key. This is required by most endpoints to access our API programatically. You can get your api key by clicking on ‘API reference’ tab under your profile icon.

​
Body

​
prompt
string
required
This is the text prompt for the image you want generated. Loras can be used by adding this in the prompt <lora:LORA_NAME:weight> where LORA_NAME is the name of the lora model and weight can be from 0 to 1, with decimal values supported.
​
negative_prompt
string
default:""
This is the text prompt describing what you don’t want to see in the image.
​
width
string
default:"512"
This is the width of the image
​
height
string
default:"512"
This is the height of the image
​
number_of_images
string
default:"1"
Number of images you want to generate
​
steps
string
default:"50"
This is the number of the denoising steps used by the AI model when generating an image. A higher number results in a longer generation time, and does not necessarily guarantee higher image quality.
​
cfg_scale
float
default:"7.0"
This is the number of the number you specify to control how closely AI model should follow the text prompt. 7 or 7.5 usually works best. You can increase the value if the generated image doesn’t match your prompt. Make sure to increment it by 0.5
​
sampler_name
string
required
This is the name of the sampler method you will be using to generate an image. Image output varies slightly depending on the method. You can pick one of the following methods
​
model_name
string
required
Specify the name of the model you’d like to use. You can find the model names here
​
controlnet_args
object[]
required
​
webhook
string
This is the callback url where you want to receive your response.
​
track_id
string
You can specify any value here to track the request that’s received on your webhook’s end.
​
seed
string
default:"-1"
This is the value that determines the output of a random number generator. You can get ALMOST the same image if you provide the same parameters and the seed.

​
Response

​
message
string
image generation in progress
curl --location "https://randomseed.lol/v1/controlnet" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer $RANDOMSEED_API_KEY" \
  --data '{
      "controlnet": {
          "prompt": "Beautiful landscape with fluffy clouds, HDR lighting, high dynamic range, vibrant colors",
          "negative_prompt": "((deformed face)), ((disfigured)), ((bad art)), ((deformed)), (disfigured face and eyes:1.1)",
          "width": "1028",
          "height": "512",
          "number_of_images": "4",
          "steps": "20",
          "cfg_scale": 8,
          "sampler_name": "Euler a",
          "model_name": "realistic_vision_v4",
          "controlnet_args": [
              {
                  "input_image": "...",
                  "module": null,
                  "model": "control_v1p_sd15_qrcode_monster"
              }
          ],
          "webhook": "...",
          "track_id": 1,
          "seed": "-1"
      }
  }'

{
    "message": "image generation in progress",
    "result": {
      "id": "...", // request id you're going to use for polling if webhook url is not provided
      "status": "IN_QUEUE"
    }
}