{ "detail": "Plan 'free' allows up to 3\". Upgrade for larger sizes." }

{
 "size_inches": ["Ensure this value is less than or equal to 15."],
 "color": "Invalid color 'rouge'. Use 'black', 'white', or hex like #RRGGBB."
}

{
 "errors": {
 "3": "size_inches > plan max (8)",
 "17": "Invalid color 'rouge'."
 },
 "rendered_before_failure": 17
}

{
 "detail": "Plan 'free' allows 1 destination edit per dynamic QR. This QR has been edited 1 time(s) already. Upgrade to Starter ($7/mo) or higher for unlimited edits, or buy a credit pack."
}

{ "detail": "Plan 'free' allows up to 3\". Upgrade for larger sizes." }

{ "detail": "Plan 'starter' caps DPI at 300. Upgrade for higher resolution." }

{ "detail": "Plan 'free' doesn't support custom logos." }

{ "detail": "Plan 'free' doesn't include bulk generation. Upgrade to Starter or higher." }

{
 "errors": {
 "3": "size_inches > plan max (8)",
 "17": "Invalid color 'rouge'."
 },
 "rendered_before_failure": 17
}

{ "detail": "Monthly quota of 5 exceeded for plan 'free'." }

HTTP/1.1 429 Too Many Requests
Retry-After: 12

{ "detail": "Render engine failure. Retry once or contact support." }

import requests

r = requests.post(
"https://api.qrstudio.agency/api/v1/generate/",
headers={"X-Api-Key": "smk_..."},
json={"data": "https://x.com", "size_inches": 4},
)

if r.status_code == 429:
showUpgradeUI()
elif r.status_code == 403:
log.warning("Plan gate: %s", r.json()["detail"])
elif r.status_code == 401:
alertOps("Bad API key")
elif not r.ok:
log.error("API error %s: %s", r.status_code, r.text)
else:
with open("qr.png", "wb") as f:
f.write(r.content)

const r = await fetch("/api/v1/generate/", );

if (r.status === 429) {
showUpgradeModal();
} else if (r.status === 403) {
const { detail } = await r.json();
console.warn("Plan gate:", detail);
} else if (r.status === 401) {
console.error("Bad API key");
} else if (!r.ok) {
console.error("Server error", r.status);
} else {
const blob = await r.blob();
// ...
}