# FitInView

AI-powered virtual wardrobe and try-on platform. Consumer app at https://fitinview.com plus a public REST API at https://api.fitinview.com.

## Public API

- API docs (HTML): https://api.fitinview.com/api/docs
- OpenAPI 3.1 spec (JSON): https://api.fitinview.com/api/v1/openapi.json
- Discovery JSON: https://api.fitinview.com/
- Developer dashboard (key minting + Stripe checkout): https://fitinview.com/developers

### What it does
POST a person photo + 1-3 garment images, get back a photorealistic image of the person wearing the clothes. Built on Gemini 3.1 Flash Image.

### Endpoints
- POST /api/v1/tryon — submit (sync up to 90s, or async + webhook)
- GET  /api/v1/tryon — list jobs (cursor-paginated)
- GET  /api/v1/tryon/{job_id} — poll status
- GET  /api/v1/account — credits + rate limits

### Auth
Bearer token. Mint at https://fitinview.com/developers. Format: `fiv_live_xxx`.

### Pricing
- 1K output: 8 credits
- 2K output: 12 credits
- 4K output: 20 credits

Pack pricing:
- Demo: $2 / 100 credits (12 try-ons)
- Starter: $25 / 1,200 credits (150 try-ons)
- Pro: $99 / 5,600 credits (700 try-ons)
- Scale: $499 / 32,000 credits (4,000 try-ons)
- Enterprise: $999 / 72,000 credits (9,000 try-ons)

### Test mode
Mint a `fiv_test_*` key from /developers — returns a stock image, $0 charged. For CI, scaffolding, integration tests.

### Agentic commerce (Stripe Shared Payment Tokens)
AI agents can purchase credit packs on behalf of their user via Stripe SPTs. POST /api/v1/credits/purchase with `pack_slug` and `shared_payment_granted_token`. Endpoint creates a PaymentIntent, returns status + credits added. Idempotent on (api_key_id, SPT). See https://docs.stripe.com/agentic-commerce for SPT details.

### Features
- Sync (`wait=true`, default) or async (`wait=false`) submission
- Webhooks (HMAC-SHA256 signed) on job completion
- Idempotency-Key header (Stripe-style)
- Custom prompt + negative_prompt
- Metadata round-trip (correlate with your own user/order IDs)
- X-RateLimit-* response headers + Retry-After on 429
- Per-key daily spend cap (configurable)
- Result PNGs on S3 with 24h presigned URLs (regenerated on each poll)

### Privacy
- Input images: not retained beyond request lifecycle
- Result images: 30 days then auto-purged
- Inputs/outputs not used for model training
- EU data residency (Hetzner Falkenstein/Helsinki)