# ProgrammaticSketch API

> REST API for hand-drawn sketch videos and SVG diagrams. Deterministic rendering, correct labels every time.

Base URL: https://api.programmaticsketch.dev
Auth: X-API-Key header. Keys minted instantly after Stripe checkout at https://llmsketch.com/#pricing.
Free watermarked previews: 2 per IP per day without a key.

## Endpoints
- POST /v1/render — body: {"prompt": "<=600 chars"} OR {"scene": SceneSpec}; "format": "mp4"|"svg"|"animated_svg". Returns job_id + poll URL. 1 credit per paid render.
- GET /v1/jobs/{id} — status: rendering|done|error; url when done.
- GET /health — liveness.
- GET /v1/pricing — plans and credit amounts.

## Errors
402 invalid key / no credits · 429 free preview limit · 422 bad scene · 503 storage gate paused.

## SceneSpec
{"title": "<=30 chars", "subtitle": "<=70 chars", "steps": [{"label": "<=16 chars", "detail": "<=30 chars"}]}
2-4 steps, left-to-right flow. Canvas 1280x720, paper #FCFAF4, ink #1A1A2E.

## Automation
n8n workflow: /downloads/n8n_blog_to_sketch.json
Make.com HTTP template: /downloads/make_http_module.json

## Plans (USD)
$15 one-time 50 credits · $19/mo 60 renders · $49/mo 250 renders · $249 one-time 10 custom videos in 24h.

## Contact
hello@programmaticsketch.dev