SpriteLab API

curl -X POST https://spritelab.dev/api/v1/generate \
  -H "Authorization: Bearer sl_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a knight in blue plate armor", "quality": "epic", "height": 64}' \
  -o knight.png

import requests

r = requests.post(
    "https://spritelab.dev/api/v1/generate",
    headers={"Authorization": "Bearer sl_live_YOUR_KEY"},
    json={"prompt": "a knight in blue plate armor", "quality": "epic", "height": 64},
)
open("knight.png", "wb").write(r.content)
print("credits left:", r.headers["X-SpriteLab-Credits-Remaining"])

import { writeFileSync } from "fs";

const res = await fetch("https://spritelab.dev/api/v1/generate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sl_live_YOUR_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ prompt: "a knight in blue plate armor", quality: "epic", height: 64 }),
});
writeFileSync("knight.png", Buffer.from(await res.arrayBuffer()));

curl -X POST https://spritelab.dev/api/v1/rotate \
  -H "Authorization: Bearer sl_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a village blacksmith", "quality": "epic", "height": 48}'

import requests, base64

r = requests.post(
    "https://spritelab.dev/api/v1/rotate",
    headers={"Authorization": "Bearer sl_live_YOUR_KEY"},
    json={"prompt": "a village blacksmith", "quality": "epic", "height": 48},
).json()

for f in r["frames"]:
    open(f'smith_{f["dir"]}.png', "wb").write(base64.b64decode(f["image_b64"]))
open("smith_sheet.png", "wb").write(base64.b64decode(r["sheet_b64"]))

const r = await fetch("https://spritelab.dev/api/v1/rotate", {
  method: "POST",
  headers: { "Authorization": "Bearer sl_live_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ prompt: "a village blacksmith", quality: "epic", height: 48 }),
}).then(x => x.json());
// r.frames[i].dir / .image_b64, r.sheet_b64, r.animated_gif_b64

curl -X POST https://spritelab.dev/api/v1/pack \
  -H "Authorization: Bearer sl_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "fantasy potions", "grid": "3x3", "variance": "family"}'

import requests, base64

r = requests.post(
    "https://spritelab.dev/api/v1/pack",
    headers={"Authorization": "Bearer sl_live_YOUR_KEY"},
    json={"prompt": "fantasy potions", "grid": "3x3", "variance": "family"},
).json()

for cell in r["cells"]:
    open(f'potion_{cell["index"]}.png', "wb").write(base64.b64decode(cell["image_b64"]))

const r = await fetch("https://spritelab.dev/api/v1/pack", {
  method: "POST",
  headers: { "Authorization": "Bearer sl_live_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ prompt: "fantasy potions", grid: "3x3", variance: "family" }),
}).then(res => res.json());

console.log(r.cells.length, "sprites,", r.credits_remaining, "credits left");

curl -X POST https://spritelab.dev/api/v1/convert \
  -H "Authorization: Bearer sl_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_b64": "iVBORw0K…", "remove_background": true, "height": 128}'

import requests, base64

src = base64.b64encode(open("photo.png", "rb").read()).decode()
r = requests.post(
    "https://spritelab.dev/api/v1/convert",
    headers={"Authorization": "Bearer sl_live_YOUR_KEY"},
    json={"image_b64": src, "remove_background": True, "height": 128},
).json()
open("pixelated.png", "wb").write(base64.b64decode(r["image_b64"]))

const r = await fetch("https://spritelab.dev/api/v1/convert", {
  method: "POST",
  headers: { "Authorization": "Bearer sl_live_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ image_b64: srcBase64, remove_background: true, height: 128 }),
}).then(res => res.json());

curl -X POST https://spritelab.dev/api/v1/micro \
  -H "Authorization: Bearer sl_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a red health potion", "size": 32, "detail": "clean"}'

import requests, base64

r = requests.post(
    "https://spritelab.dev/api/v1/micro",
    headers={"Authorization": "Bearer sl_live_YOUR_KEY"},
    json={"prompt": "a red health potion", "size": 32, "detail": "clean"},
).json()
open("potion.png", "wb").write(base64.b64decode(r["image_b64"]))
print("closed outline:", r["outline_gaps"] == 0)

const r = await fetch("https://spritelab.dev/api/v1/micro", {
  method: "POST",
  headers: { "Authorization": "Bearer sl_live_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ prompt: "a red health potion", size: 32, detail: "clean" }),
}).then(res => res.json());

curl -X POST https://spritelab.dev/api/v1/reskin \
  -H "Authorization: Bearer sl_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_b64": "iVBORw0K…", "themes": ["lava", "ice", "gold"], "variants": 3}'

import requests, base64

r = requests.post(
    "https://spritelab.dev/api/v1/reskin",
    headers={"Authorization": "Bearer sl_live_YOUR_KEY"},
    json={"image_b64": src, "themes": ["lava", "ice", "gold"], "variants": 3},
).json()
for v in r["variants"]:
    open(f'{v["theme"]}.png', "wb").write(base64.b64decode(v["image_b64"]))

const r = await fetch("https://spritelab.dev/api/v1/reskin", {
  method: "POST",
  headers: { "Authorization": "Bearer sl_live_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ image_b64: src, themes: ["lava", "ice", "gold"], variants: 3 }),
}).then(res => res.json());

curl -X POST https://spritelab.dev/api/v1/merge \
  -H "Authorization: Bearer sl_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target_b64": "iVBORw0K…", "donor_b64": "iVBORw0K…", "apply_as": "armor", "variants": 2}'

import requests, base64

r = requests.post(
    "https://spritelab.dev/api/v1/merge",
    headers={"Authorization": "Bearer sl_live_YOUR_KEY"},
    json={"target_b64": hero, "donor_b64": armor, "apply_as": "armor", "variants": 2},
).json()
for i, v in enumerate(r["variants"]):
    open(f"merged_{i}.png", "wb").write(base64.b64decode(v["image_b64"]))

const r = await fetch("https://spritelab.dev/api/v1/merge", {
  method: "POST",
  headers: { "Authorization": "Bearer sl_live_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ target_b64: hero, donor_b64: armor, apply_as: "armor", variants: 2 }),
}).then(res => res.json());

curl -X POST https://spritelab.dev/api/v1/backgrounds \
  -H "Authorization: Bearer sl_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a misty pine forest at dawn", "width": 1920, "height": 1080}'

import requests, base64

r = requests.post(
    "https://spritelab.dev/api/v1/backgrounds",
    headers={"Authorization": "Bearer sl_live_YOUR_KEY"},
    json={"prompt": "a misty pine forest at dawn", "width": 1920, "height": 1080},
).json()
open("forest.png", "wb").write(base64.b64decode(r["image_b64"]))

const r = await fetch("https://spritelab.dev/api/v1/backgrounds", {
  method: "POST",
  headers: { "Authorization": "Bearer sl_live_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ prompt: "a misty pine forest at dawn", width: 1920, height: 1080 }),
}).then(res => res.json());

curl -X POST https://spritelab.dev/api/v1/tileset \
  -H "Authorization: Bearer sl_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "lush grass", "base_prompt": "dirt", "layout": "15"}'

import requests, base64

r = requests.post(
    "https://spritelab.dev/api/v1/tileset",
    headers={"Authorization": "Bearer sl_live_YOUR_KEY"},
    json={"prompt": "lush grass", "base_prompt": "dirt", "layout": "15"},
).json()

# the atlas + the drop-in engine files
open(r["atlas_filename"], "wb").write(base64.b64decode(r["atlas_b64"]))
open("terrain.tres", "w").write(r["godot_tres"])  # Godot 4
open("terrain.tsx", "w").write(r["tiled_tsx"])    # Tiled

const r = await fetch("https://spritelab.dev/api/v1/tileset", {
  method: "POST",
  headers: { Authorization: "Bearer sl_live_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ prompt: "lush grass", base_prompt: "dirt", layout: "15" }),
}).then(r => r.json());
// r.atlas_b64, r.godot_tres, r.tiled_tsx

# 1. submit
curl -X POST https://spritelab.dev/api/v1/animate \
  -H "Authorization: Bearer sl_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_b64": "iVBORw0K…", "prompt": "gentle idle bounce", "frames": 8}'
# -> { "job_id": "a1b2…", "status": "queued" }

# 2. poll until succeeded
curl https://spritelab.dev/api/v1/jobs/a1b2… \
  -H "Authorization: Bearer sl_live_YOUR_KEY"

import requests, time, base64

h = {"Authorization": "Bearer sl_live_YOUR_KEY"}
job = requests.post("https://spritelab.dev/api/v1/animate", headers=h,
    json={"image_b64": src, "prompt": "gentle idle bounce", "frames": 8}).json()

while True:
    s = requests.get(f'https://spritelab.dev/api/v1/jobs/{job["job_id"]}', headers=h).json()
    if s["status"] in ("succeeded", "failed"):
        break
    time.sleep(3)

if s["status"] == "succeeded":
    open("anim.gif", "wb").write(base64.b64decode(s["gif_b64"]))

const h = { "Authorization": "Bearer sl_live_YOUR_KEY", "Content-Type": "application/json" };
const job = await fetch("https://spritelab.dev/api/v1/animate", {
  method: "POST", headers: h,
  body: JSON.stringify({ image_b64: src, prompt: "gentle idle bounce", frames: 8 }),
}).then(r => r.json());

let s;
do {
  await new Promise(r => setTimeout(r, 3000));
  s = await fetch(`https://spritelab.dev/api/v1/jobs/${job.job_id}`, { headers: h }).then(r => r.json());
} while (!["succeeded", "failed"].includes(s.status));

curl -X POST https://spritelab.dev/api/v1/resize \
  -H "Authorization: Bearer sl_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sprite_id": "3f9a…c1", "height": 32, "max_colours": 8}' \
  -o small.png

import requests

r = requests.post(
    "https://spritelab.dev/api/v1/resize",
    headers={"Authorization": "Bearer sl_live_YOUR_KEY"},
    json={"sprite_id": "3f9a…c1", "height": 32, "max_colours": 8},
)
open("small.png", "wb").write(r.content)

const res = await fetch("https://spritelab.dev/api/v1/resize", {
  method: "POST",
  headers: { "Authorization": "Bearer sl_live_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ sprite_id: "3f9a…c1", height: 32, max_colours: 8 }),
});
writeFileSync("small.png", Buffer.from(await res.arrayBuffer()));

curl -X POST https://spritelab.dev/api/v1/enhance-prompt \
  -H "Authorization: Bearer sl_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "knight"}'

import requests
r = requests.post("https://spritelab.dev/api/v1/enhance-prompt",
    headers={"Authorization": "Bearer sl_live_YOUR_KEY"},
    json={"prompt": "knight"}).json()
print(r["enhanced"])

const r = await fetch("https://spritelab.dev/api/v1/enhance-prompt", {
  method: "POST",
  headers: { "Authorization": "Bearer sl_live_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ prompt: "knight" }),
}).then(res => res.json());

curl https://spritelab.dev/api/v1/credits \
  -H "Authorization: Bearer sl_live_YOUR_KEY"

import requests
r = requests.get("https://spritelab.dev/api/v1/credits",
    headers={"Authorization": "Bearer sl_live_YOUR_KEY"}).json()
print(r["credits"], r["tier"])

const r = await fetch("https://spritelab.dev/api/v1/credits", {
  headers: { "Authorization": "Bearer sl_live_YOUR_KEY" },
}).then(res => res.json());

curl -X POST https://spritelab.dev/api/v1/palettes \
  -H "Authorization: Bearer sl_live_YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Dusk", "colours": "#1D2B53 #7E2553 #FF004D #FFEC27"}'

import requests
H = {"Authorization": "Bearer sl_live_YOUR_KEY"}
p = requests.post("https://spritelab.dev/api/v1/palettes", headers=H,
    json={"name": "Dusk", "colours": ["#1D2B53", "#7E2553", "#FF004D", "#FFEC27"]}).json()
# then on any sprite call: {"prompt": "...", "palette_lock": f"palette:{p['id']}"}

const p = await fetch("https://spritelab.dev/api/v1/palettes", {
  method: "POST",
  headers: { "Authorization": "Bearer sl_live_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ name: "Dusk", colours: "#1D2B53 #7E2553 #FF004D #FFEC27" }),
}).then(res => res.json());