← API OVERVIEW

Sprite Packs

N distinct sprites in ONE generation call, split server-side into ready-to-use PNGs. The cheapest per-sprite path on the API: a 3x3 epic pack is 2 credits for 9 sprites, against 1 credit each individually.

POST /pack

Field	Type	Notes
prompt	string, required	The subject or theme: "medieval weapons", "forest creatures", "cozy cafe food items". Max 500 chars
grid	string	2x2 to 8x8, default 3x3. Above 3x3 needs an active subscription. Per-sprite detail drops past 5x5 (one generation is being split into more cells)
variance	string	variants = same subject, mild pose/detail variation. family (default) = related designs on the theme. wild = highly varied
quality	string	epic (default) or mythic
sheet_height	int	128 to 1024. Height of the cleaned sheet; default 256 up to 5x5, size-scaled beyond

Python:

import base64, requests

r = requests.post(
    "https://spritelab.dev/api/v1/pack",
    headers={"Authorization": "Bearer sl_live_YOUR_KEY"},
    json={"prompt": "medieval fantasy weapons", "grid": "3x3", "variance": "family"},
    timeout=180,
)
r.raise_for_status()
out = r.json()
open("weapons_sheet.png", "wb").write(base64.b64decode(out["sheet_b64"]))
for cell in out["cells"]:
    open(f"weapon_{cell['index']:02d}.png", "wb").write(base64.b64decode(cell["image_b64"]))
print(len(out["cells"]), "sprites for", out["cost"], "credits")

Response envelope:

{
  "id": "d7e1…",              # history row: the app's Split tool works on it too
  "mode": "pack",
  "grid": "3x3",
  "sheet_b64": "…",           # the full cleaned spritesheet
  "width": 256, "height": 256,
  "cells": [                   # row-major, cropped tight to each sprite's pixels
    {"index": 0, "image_b64": "…", "width": 78, "height": 74},
    …
  ],
  "cost": 2,
  "credits_remaining": 372
}

Notes

• Cells are cropped from the cleaned sheet exactly as drawn, tight to each sprite's opaque pixels, so sizes vary per sprite by design (a dagger is smaller than a halberd).
• The model occasionally draws fewer sprites than cells; empty cells are simply omitted from cells. You're charged per call, not per sprite.
• The pack also lands in your SpriteLab history as one sheet, where the app's Split tool, retuning and Animate Pack all work on it.
• Consistency across a pack is a strength: everything shares one generation, so palette and rendering style match by construction.