# AI Pricing Agent Guide

AI Pricing is a public Cloudflare Worker and React SPA that exposes live,
queryable AI model API pricing.

## Installation

```bash
git clone https://github.com/erans/ai-pricing.git
cd ai-pricing
npm install
( cd frontend && npm install )
```

## Configuration

Production runs on Cloudflare Workers with D1, Workers AI, static assets,
and rate-limit bindings. Local development uses Wrangler:

```bash
npm run dev
```

Admin endpoints require an `ADMIN_TOKEN` secret. Public API endpoints under
`/v1/*` do not require authentication.

## Usage

Fetch current prices:

```bash
curl "https://ai-pricing.fyi/v1/prices/current?provider=anthropic&limit=20"
```

Fetch Cloudflare AI Gateway proxied availability:

```bash
curl "https://ai-pricing.fyi/v1/models?provider=cloudflare&deployment_mode=proxied&limit=20"
curl "https://ai-pricing.fyi/v1/models/claude-opus-4.7/offers"
```

Cloudflare AI Gateway proxied offers are availability rows with
`pricing_status: "proxied"`. They do not appear in
`/v1/prices/current`, which returns numeric current prices only.

Fetch markdown API docs:

```bash
curl -H "Accept: text/markdown" https://ai-pricing.fyi/api
curl https://ai-pricing.fyi/api.md
```

## Key Resources

- [API documentation](/api.md)
- [OpenAPI schema](/openapi.json)
- [Sitemap](/sitemap.md)