Pony Realism character generator

Pony Realism API

SDXL-based image generation. Three ways to call /generate: plain prompt, explicit per-request LoRAs, or the easy mode via named characters.

1. Plain prompt (no LoRA)

curl -X POST http://localhost:5004/generate \
  -H 'Authorization: Bearer sk-...' \
  -H 'Content-Type: application/json' \
  -d '{"prompt":"score_9, 1girl, portrait","negative_prompt":"score_4","width":1024,"height":1024,"num_steps":25,"guidance_scale":5.5}' \
  -o out.png

Field	Type	Default	Notes
prompt	string	required	Use Pony score_X tags for quality
negative_prompt	string	""	What to avoid
fast	bool	false	Enables SDXL Lightning (8 steps, CFG 1.5)
num_steps	int	25 (quality) / 8 (fast)	1–100
guidance_scale	float	5.5 (quality) / 1.5 (fast)	0–20
width / height	int	1024 / 1024	256–2048, snap to 8
seed	int	random	Reproducibility

2. Explicit LoRAs

curl -X POST http://localhost:5004/generate \
  -H 'Authorization: Bearer sk-...' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt":"score_9, 1girl, red hair, portrait",
    "loras":[{"name":"my-lora","weight":0.9}]
  }' \
  -o out.png

Endpoint	Purpose
GET/loras	List loaded adapters
POST/loras	Upload .safetensors
PATCH/loras/<name>	Set weight / saved_weight / saved_steps / prompt
DELETE/loras/<name>	Remove adapter + file + thumbnails

3. Characters (easy mode)

A character bundles a LoRA + base prompt + weight + steps under one name. Call /generate with just character and optional extra prompt.

curl -X POST http://localhost:5004/generate \
  -H 'Authorization: Bearer sk-...' \
  -H 'Content-Type: application/json' \
  -d '{"character":"julie","prompt":"on a beach, golden hour"}' \
  -o out.png

Managing characters

Endpoint	Body / purpose
GET/characters	List all characters
POST/characters	{name, lora, base_prompt, negative_prompt?, weight?, steps?}
PATCH/characters/<name>	Any subset of the above (except name/lora)
DELETE/characters/<name>	Delete + cleanup thumbnail
POST/characters/<name>/thumbnail	Render thumbnail from base prompt alone
GET/characters/<name>/thumbnail	Serve PNG

CivitAI

Endpoint	Purpose
GET/civitai/search?q=&base=Pony	Search LoRAs
GET/civitai/model/<id>	All versions + samples
POST/civitai/import	{model_version_id, force?}

Health

curl http://localhost:5004/health