RunPod Partners With RandomSeed to Provide Accessible, User-Friendly Stable Diffusion API Access

RunPod is delighted to collaborate with RandomSeed by providing the serverless compute power required to create generative AI art through their API access. The mission of RandomSeed is to help developers build AI image generators by providing a hosted AUTOMATIC1111 API that can create images on-demand through API calls, saving developers the burden of having to host and manage their own infrastructure for Stable Diffusion.

The Benefits of Serverless Pricing

RandomSeed helps leverage the serverless capacity of RunPod by providing a user-friendly method to interact with Stable Diffusion through API calls with none of the technical expertise that would normally be required in building and maintaining such a setup. All you have to do is pass your parameters to RandomSeed in an API request and you'll have your image served wherever it needs to go. The end result is that you only pay for the server time you actually use, which ends up costing you an average of a cent (or even less) per image. This means that your costs scale with your needs, compared to the static, per-hour price of renting a pod.

RandomSeed even has a playground that you can use to test out the service and see if it's a good fit for you:

AUTOMATIC1111 API documentation

RandomSeed has graciously contributed the following documentation on how to pass requests to the Stable Diffusion API.

AUTOMATIC1111 has emerged as a leading tool for image generation through stable diffusion, boasting a comprehensive API that enables a multitude of functions. However, it’s near impossible to find in-depth documentation explaining what each parameter does. In this article, we attempt to share our findings from using the API while running our own cloud-based AUTOMATIC1111 API at RandomSeed.

txt2img

ControlNet Model to Module Mapping

img2img

Example Calls

We’re going to show you how you can use the API to do some basic image generations. Make sure that you have cloned the auto1111 repo from here, and have it running locally on your PC.

txt2img generation:

curl http://127.0.0.1:7860/sdapi/v1/txt2img \
  -H "Content-Type: application/json" \
  -d '{
   “prompt”: “Cute cat”,
   “negative_prompt”: “ugly, out of frame”,
   “width”: 1028, 
   “height”: 1028,
   “cfg_scale”: 7,
   “sampler_name”: “Euler a”,
   “steps”: 25,
   “n_iter”: 1,
   “seed”: 3315716384
  }'

img2img generation:

curl http://127.0.0.1:7860/sdapi/v1/img2img \
  -H "Content-Type: application/json" \
  -d '{
   “prompt”: “cute dog”,
   “negative_prompt”: “ugly, out of frame”,
   “width”: 1028, 
   “height”: 1028,
   “cfg_scale”: 7,
   “sampler_name”: “Euler a”,
   “steps”: 25,
   “n_iter”: 1,
   “seed”: -1,
   “include_init_images”: true,
   “init_images”: [“....”], //using the base64 encoded image from the txt2img api call from above
   “denoising_strength”: 0.6
  }'

Inpainting example:

We’re going to inpaint over the dog’s ears for this example.

curl http://127.0.0.1:7860/sdapi/v1/img2img \
  -H "Content-Type: application/json" \
  -d '{
   “prompt”: “cute dog, (smaller ears:1.4)”,
   “negative_prompt”: “ugly, out of frame”,
   “width”: 1028, 
   “height”: 1028,
   “cfg_scale”: 7,
   “sampler_name”: “Euler a”,
   “steps”: 25,
   “n_iter”: 1,
   “seed”: -1,
   “include_init_images”: true,
   “init_images”: [“....”], //using the base64 encoded image from the img2img api call from above
   “mask”: “...”, // base64 encoded mask object. It should cover the dog’s ears
   “denoising_strength”: 0.6,
   “image_cfg_scale”: 0.7,
   “inpainting_fill” : 1,
   “inpaint_full_res”: false,
   “inpainting_mask_inverse”: 0,
   “inpaint_full_res_padding”: 32
  }'

QR Monster ControlNet (Illusion Diffusion)

QR Monster Controlnet is taking the internet by storm. If you want to generate images like this, or this, you can make the request like below:

curl http://127.0.0.1:7860/sdapi/v1/img2img \
  -H "Content-Type: application/json" \
  -d '{
   “prompt”: “cute dog”,
   “negative_prompt”: “ugly, out of frame”,
   “width”: 1028, 
   “height”: 1028,
   “cfg_scale”: 7,
   “sampler_name”: “Euler a”,
   “steps”: 25,
   “n_iter”: 1,
   “seed”: -1,
   “include_init_images”: true,
   “init_images”: [“....”], //using the base64 encoded image from the img2img api call from above
   “denoising_strength”: 0.7,
   “controlnet_args”: [
      {
         “input_image”: “...”, //base64 encoded image. You can use this image but convert it to base64 string: https://i.imgur.com/9NRTUvK.png
          “module”: null,
          “model”: “control_v1p_sd15_qrcode_monster”
      }
   ]
  }'

Conclusion

We hope this documentation gives you a good starting point for generating images with AUTO1111 API. As you work with the API, don't be afraid to tweak the settings and observe its impact. Refer to the documentation and examples as needed. With some practice, you'll be leveraging AUTOMATIC1111 to create amazing AI artworks.1 Let us know if you make something cool!