# PixelVault

> Agent-first image hosting API. Upload images via API, get instant CDN URLs.
> Free tier: 200 MB storage, 500 uploads/month, 1 GB bandwidth. No credit card required.

## API Base URL

https://api.pixelvault.dev

## Authentication

All endpoints except registration require a Bearer token:
  Authorization: Bearer pv_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

API keys use the prefix `pv_live_` for production and `pv_test_` for test environments.

## Endpoints

### Register (no auth required)
POST /v1/auth/register
Body: {"email": "you@example.com", "password": "your-secure-password"}
Returns: account, default project, and API key (shown only once)

### Upload image
POST /v1/images
Content-Type: multipart/form-data
Form field: file (binary, required), folder (string, optional)
Supported formats: JPEG, PNG, GIF, WebP, AVIF, SVG
Returns: image ID, CDN URL, mime type, size, dimensions

### List images
GET /v1/images?page=1&per_page=20
Returns: paginated list of images with metadata

### Get image
GET /v1/images/:id
Returns: image metadata and CDN URL

### Delete image
DELETE /v1/images/:id
Returns: success confirmation

## Resources

- OpenAPI 3.1 spec: https://api.pixelvault.dev/openapi.json
- Documentation: https://pixelvault.dev/docs
- Pricing: https://pixelvault.dev/pricing