API

API guide by @Kilvoctu

• First, of course, is to run web ui with --api commandline argument
  • example in your "webui-user.bat": set COMMANDLINE_ARGS=--api
• This enables the api which can be reviewed at http://127.0.0.1:7860/docs (or whever the URL is + /docs) The basic ones I'm interested in are these two. Let's just focus only on /sdapi/v1/txt2img

• When you expand that tab, it gives an example of a payload to send to the API. I used this often as reference.

---

• So that's the backend. The API basically says what's available, what it's asking for, and where to send it. Now moving onto the frontend, I'll start with constructing a payload with the values I want. An example can be:

payload = {
    "prompt": "maltese puppy",
    "steps": 5
}

I can put in as few or as many values as I want in the payload. The API will use the defaults for anything I don't set.

• After that, I can send it to the API

response = requests.post(url=f'http://127.0.0.1:7860/sdapi/v1/txt2img', json=payload)

Again, this URL needs to match the web ui's URL. If we execute this code, the web ui will generate an image based on the payload. That's great, but then what? There is no image anywhere...

---

• After the backend does its thing, the API sends the response back in a variable that was assigned above: response. The response contains three entries; "images", "parameters", and "info", and I have to find some way to get the information from these entries.
• First, I put this line r = response.json() to make it easier to work with the response.
• "images" is the generated image, which is what I want mostly. There's no link or anything; it's a giant string of random characters, apparently we have to decode it. This is how I do it:

for i in r['images']:
    image = Image.open(io.BytesIO(base64.b64decode(i.split(",",1)[1])))

• With that, we have an image in the image variable that we can work with, for example saving it with image.save('output.png').
• "parameters" shows what was sent to the API, which could be useful, but what I want in this case is "info". I use it to insert metadata into the image, so I can drop it into web ui PNG Info. For that, I'll backtrack a little bit and pull what I need, which is nested in "info"

load_r = json.loads(r['info'])
meta = load_r["infotexts"][0]

---

A sample code that should work can look like this:

import json
import requests
import io
import base64
from PIL import Image, PngImagePlugin

url = "http://127.0.0.1:7860"

payload = {
    "prompt": "puppy dog",
    "steps": 5
}

response = requests.post(url=f'{url}/sdapi/v1/txt2img', json=payload)

r = response.json()
load_r = json.loads(r['info'])
meta = load_r["infotexts"][0]

for i in r['images']:
    image = Image.open(io.BytesIO(base64.b64decode(i.split(",",1)[1])))
    pnginfo = PngImagePlugin.PngInfo()
    pnginfo.add_text("parameters", meta)
    image.save('output.png', pnginfo=pnginfo)

• Import the things I need
• define the url and the payload to send
• send said payload to said url through the API
• when I get the response, grab png info from "infotexts" inside of "info"
• then grab "images" and decode it
• define a plugin to add png info, then add the png info I defined into it
• at the end here, save the image with the png info

This is as of commit e725474

For a more complete implementation of a frontend, my Discord bot is here if anyone wants to look at it as an example. Most of the action happens in stablecog.py. There are many comments explaining what each code does.

---

This guide can be found in discussions page.