v1/txt2img

curl --location "https://randomseed.lol/v1/txt2img" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer $RANDOMSEED_API_KEY" \
  --data '{
      "txt2img": {
          "prompt": "Cute cat",
          "negative_prompt": "ugly, out of frame",
          "width": "512",
          "height": "512",
          "number_of_images": "1",
          "steps": "20",
          "cfg_scale": 7,
          "sampler_name": "Euler a",
          "model_name": "realistic_vision_v4",
          "webhook": "..." //replace with your own webhook url,
          "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"
  }
}

curl --location "https://randomseed.lol/v1/txt2img" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer $RANDOMSEED_API_KEY" \
  --data '{
      "txt2img": {
          "prompt": "Cute cat",
          "negative_prompt": "ugly, out of frame",
          "width": "512",
          "height": "512",
          "number_of_images": "1",
          "steps": "20",
          "cfg_scale": 7,
          "sampler_name": "Euler a",
          "model_name": "realistic_vision_v4",
          "webhook": "..." //replace with your own webhook url,
          "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

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

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.

string

default:""

This is the text prompt describing what you don’t want to see in the image.

string

default:"512"

This is the width of the image

string

default:"512"

This is the height of the image

string

default:"1"

Number of images you want to generate

string

default:"50"

This is the number of the denoising steps used by the AI model when generating an image from the text prompt. A higher number results in a longer generation time, and does not necessarily guarantee higher image quality.

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. Increment it by 0.5.

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

string

required

Specify the name of the model you’d like to use. You can find the model names here

string

Refer to the following table for supported methods.

float

default:"0.7"

Make sure to set this value when you’re using this when passing in the highres fix method.

string

This is the callback url where you want to receive your response.

string

You can specify any value here to track the request that’s received on your webhook’s end.

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

string

image generation in progress

curl --location "https://randomseed.lol/v1/txt2img" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer $RANDOMSEED_API_KEY" \
  --data '{
      "txt2img": {
          "prompt": "Cute cat",
          "negative_prompt": "ugly, out of frame",
          "width": "512",
          "height": "512",
          "number_of_images": "1",
          "steps": "20",
          "cfg_scale": 7,
          "sampler_name": "Euler a",
          "model_name": "realistic_vision_v4",
          "webhook": "..." //replace with your own webhook url,
          "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"
  }
}

Quick Start

Endpoints

API key

Headers

Body

Response

​API key

​Headers

​Body

​Response

API key

Headers

Body

Response