{"openapi":"3.1.0","info":{"title":"PixelForge Public Agent & Sprite Pack API","version":"2.0.0","description":"Programmatic interface for AI coding agents and game tools to fetch the free PixelForge schema-v2 starter pack or submit a portrait photo for a $5 Stripe-backed 4-direction RPG character sprite pack.","contact":{"name":"PixelForge Support","email":"hello@pixel-forge.net","url":"https://pixel-forge.net/"}},"servers":[{"url":"https://pixel-forge.net","description":"Production"}],"paths":{"/health":{"get":{"operationId":"getHealth","summary":"Check service and generator readiness","responses":{"200":{"description":"Service health snapshot"}}}},"/samples/starter-pack.zip":{"get":{"operationId":"downloadStarterPack","summary":"Download free commercial/CC0 schema-v2 4-direction starter sprite pack ZIP","responses":{"200":{"description":"ZIP archive (application/zip)"}}}},"/samples/manifest.json":{"get":{"operationId":"getStarterManifest","summary":"Inspect schema-v2 manifest.json structure without downloading the ZIP","responses":{"200":{"description":"Schema-v2 manifest JSON"}}}},"/api/jobs":{"post":{"operationId":"createSpriteJob","summary":"Upload one portrait photo and open a $5 Stripe Checkout session","description":"Send multipart/form-data with `Accept: application/json`. Pre-validates single-face visibility before creating a Stripe Checkout URL. No charge occurs until the human completes Stripe Checkout at `checkout_url`.","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["photo"],"properties":{"photo":{"type":"string","format":"binary","description":"Front-facing single-person photo (JPEG, PNG, WebP, or HEIC <= 12MB)."},"notes":{"type":"string","description":"Optional outfit or trait notes (e.g. 'keep glasses and red hoodie')."},"email":{"type":"string","description":"Optional receipt/delivery email prefill for Stripe Checkout."}}}}}},"responses":{"200":{"description":"Job created (when Accept: application/json is supplied)","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"job_id":{"type":"string"},"status":{"type":"string","enum":["checkout_created","needs_photo"]},"redirect_url":{"type":"string"},"checkout_url":{"type":["string","null"]},"status_url":{"type":"string"},"download_url":{"type":"string"},"order_page_url":{"type":"string"},"photo_issue":{"type":"string"}}}}}},"400":{"description":"Invalid or unsupported image upload"},"413":{"description":"Upload exceeds 12MB"},"429":{"description":"Rate limit exceeded"}}}},"/api/jobs/{job_id}":{"get":{"operationId":"getSpriteJob","summary":"Poll sprite pack order status and artifact URLs","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Job status (`checkout_created`, `queued`, `processing`, `complete`, `failed`, `needs_photo`)"},"404":{"description":"Job not found"}}}},"/api/jobs/{job_id}/download":{"get":{"operationId":"downloadSpritePack","summary":"Download finished sprite-package.zip once status is complete","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Finished sprite-package.zip (application/zip)"},"404":{"description":"Job not found or artifact not ready"}}}}}}