HTTP API

curl -X POST https://tia.dohunkim.xyz/api/audit \
  -F "image=@banner.png" \
  -F "level=AA"

import requests

with open("banner.png", "rb") as f:
    r = requests.post(
        "https://tia.dohunkim.xyz/api/audit",
        files={"image": ("banner.png", f, "image/png")},
        data={"level": "AA"},
        timeout=90,
    )

if r.ok:
    report = r.json()
    for region in report["regions"]:
        print(region["verdict"], region["contrast_ratio"], region["text"])
else:
    print(r.status_code, r.json()["detail"])

// Browser or Node 18+. In the browser, take the file from an <input type="file">.
const form = new FormData();
form.append("image", file);      // a File or Blob
form.append("level", "AA");

const res = await fetch("https://tia.dohunkim.xyz/api/audit", { method: "POST", body: form });
const body = await res.json();

if (!res.ok) throw new Error(body.detail);
console.log(body.summary);       // { regions, passing, failing, review }

{
  "image": { "width": 1200, "height": 630 },
  "level": "AA",
  "summary": { "regions": 3, "passing": 1, "failing": 1, "review": 1 },
  "regions": [
    {
      "id": 0,
      "location": { "x": 96, "y": 120, "width": 520, "height": 140 },
      "text": "Spring sale starts today",
      "verdict": "fail",
      "contrast_ratio": 1.5,
      "required_ratio": 3,
      "text_size": "large",
      "low_vision": [
        { "reader": "20/20", "reading": "difficult" },
        { "reader": "20/40", "reading": "unreadable" },
        { "reader": "20/80", "reading": "unreadable" },
        { "reader": "20/200", "reading": "unreadable" }
      ],
      "guidance": "TIA reads this at about 1.5:1; WCAG AA needs 3:1 for large text. ..."
    },
    {
      "id": 1,
      "location": { "x": 96, "y": 300, "width": 610, "height": 36 },
      "text": "Free delivery on every order this week",
      "verdict": "pass",
      "contrast_ratio": 12.7,
      "required_ratio": 4.5,
      "text_size": "normal",
      "low_vision": [ ... ],
      "guidance": "Meets WCAG AA contrast for normal text (12.7:1, needs 4.5:1 or more)."
    },
    {
      "id": 2,
      "location": { "x": 96, "y": 400, "width": 180, "height": 44 },
      "text": "Shop the sale",
      "verdict": "review",
      "contrast_ratio": 4.9,
      "required_ratio": 4.5,
      "text_size": "normal",
      "low_vision": null,
      "guidance": "Couldn't measure this region confidently, so please check it by hand. ..."
    }
  ],
  "notes": [
    "Each text region is checked against its own background.",
    "..."
  ],
  "provenance": {
    "basis": "image-pixels",
    "independent": true,
    "disclosure": "Every color in this result was read from the uploaded image's own pixels; ..."
  }
}