# MapleAI

> Pay-per-use GPT models via x402 micropayments on Polygon mainnet.

GPT API access with pay-per-request pricing: 4 GPT models behind one
OpenAI-compatible endpoint. No accounts, no subscriptions, no API keys — an agent pays
per request in USDC over the x402 protocol.

## Payment

- Protocol: x402
- Network: eip155:137 (Polygon mainnet)
- Currency: USDC (0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359)
- Recipient: 0x63db6eaf635a31bbc6714fe37bdc85243864f611
- Facilitator: https://facilitator.payai.network
- Minimum charge: $0.0010 per paid request (about $0.001 rounded)
- Contact: contact@mapleai.shop

## Endpoints

POST https://polygon.mapleai.shop/v1/chat/completions
  OpenAI-compatible chat completions (paid).
  Returns HTTP 402 with a PAYMENT-REQUIRED header when payment is required.
  Price = input_tokens * input_rate + max_tokens * output_rate.

POST https://polygon.mapleai.shop/api/v1/chat/completions
  Alias of the above, for agent crawlers (paid).

POST https://polygon.mapleai.shop/api/v1/responses
  OpenAI-compatible Responses API, alpha (paid).

GET https://polygon.mapleai.shop/v1/models
  List all available models with pricing (free).

POST https://polygon.mapleai.shop/api/v1/images/generations
  Generate images (paid; per image and size).
POST https://polygon.mapleai.shop/api/v1/images/image2image
  Edit a PNG, JPEG or WebP base64 data URI (paid; maximum 10 MB).

POST https://polygon.mapleai.shop/jev
  Jev structured decisions ($0.12/1M input tokens plus payment overhead). Send model=jev-latest, state and named questions with type and instructions.

POST https://polygon.mapleai.shop/v1/embeddings
  Free NVIDIA embeddings with nvidia/nemotron-3-embed-1b.

POST https://polygon.mapleai.shop/v1/free/chat/completions
  Free nvidia/gpt-oss-20b chat completions (no payment). Rate-limited:
  10 requests/10min and 100 requests/day per agent IP;
  max_tokens capped at 2048. Returns 429 free_tier_exhausted
  with retry-after when the window is spent.
GET https://polygon.mapleai.shop/v1/free/chat/completions/quota
  Current free-tier window usage for your IP (free).

POST https://polygon.mapleai.shop/prepaid/codes
  Buy a prepaid API key for one GPT model (paid). Budget in 100000-token steps
  from 100000 to 1000000, priced at the model input rate plus settlement fee.
  The key works at https://mapleai.shop/v1 (OpenAI-compatible).
GET https://mapleai.shop/v1/prepaid/status
  Check prepaid key usage and status (free). Send the prepaid key as the
  Bearer token; returns valid, reason and tokens total/used/reserved/remaining.

## Available Models

- openai/gpt-5.6-sol
  GPT-5.6 Sol: $2.80/1M in, $14.00/1M out, 1.1M context
- openai/gpt-5.6-terra
  GPT-5.6 Terra: $1.40/1M in, $8.40/1M out, 1.1M context
- openai/gpt-6-luna
  GPT-6 Luna: $0.07/1M in, $0.35/1M out, 1.1M context
- openai/gpt-6-sol
  GPT-6 Sol: $1.40/1M in, $7.00/1M out, 1.1M context

## Image Models

- gpt-image-2 (1024x1024): $0.0200 per image
- gpt-image-2.5 (1024x1024): $0.0400 per image
- gpt-image-2.5-flare (1024x1024): $0.0400 per image
- gpt-image-2.5-sunburst (1024x1024): $0.0400 per image
- grok-imagine-image (1024x1024): $0.0450 per image
- gpt-image-2-2k (2048x2048): $0.0900 per image
- gpt-image-2.5-sunburst-2k (2048x2048): $0.2200 per image

Send model, size, prompt and optional n (1-4). Edits also require image as a base64 data URI.
The x402 challenge includes payment overhead. Successful responses contain data[].url or data[].b64_json.

## Jev

- jev-latest: $0.12/1M input tokens; output tokens free
- SystemOne only. POST /jev with model, state and named questions; each question needs type (noul, choice or score) and instructions. Read answers from the response.

## Usage

1. Make a request to https://polygon.mapleai.shop/v1/chat/completions without payment
2. Receive HTTP 402 with a PAYMENT-REQUIRED header describing price and payment options
3. Sign the transfer authorization with your wallet (x402 client libraries do this automatically)
4. Retry the request with the PAYMENT-SIGNATURE header
5. Receive the completion

## Discovery

https://polygon.mapleai.shop/service-endpoints.json - one-shot machine-readable index of routes, access modes and pricing
https://polygon.mapleai.shop/.well-known/x402 - x402 discovery document
https://polygon.mapleai.shop/.well-known/agent-card.json - A2A agent card with skills
https://polygon.mapleai.shop/openapi.json - OpenAPI 3.1 specification
https://polygon.mapleai.shop/AI-AGENTS.md - integration guide for agents
https://polygon.mapleai.shop/llms.txt - this file