OCR API

Extract text from images using optical character recognition. Upload an image containing text and get back the recognized content as a string.

POST https://pylon-ocr-api.fly.dev/ocr

Endpoint

Base URL:

https://pylon-ocr-api.fly.dev

Parameters

ParameterTypeRequiredDescription
filefile (multipart)YesImage file containing text (PNG, JPEG, WebP)

Response

Returns JSON with extracted text (200 OK).

{
  "text": "Extracted text from the image...",
  "confidence": 0.97
}
StatusDescription
200Extracted text returned as JSON
402Payment required — x402 challenge returned
400Missing or invalid image file
500OCR processing failed

Pricing

$0.01 USDC per request — paid via x402 on Base Sepolia. No API key. No subscription. Pay per call.

Code Examples

curl -X POST "https://pylon-ocr-api.fly.dev/ocr" \
  -F "file=@receipt.png"

x402 Setup

To use Pylon APIs, you need an x402-compatible client with a funded wallet on Base Sepolia. Here's the quick setup:

  1. Get a wallet with USDC on Base Sepolia (testnet)
  2. Install an x402 client library (x402.org Status Terms Privacy for options)
  3. Configure it with your private key
  4. Make requests — the client handles the 402 payment flow automatically

The x402 flow: your first request returns 402 Payment Required with payment details in headers. The x402 client signs a USDC payment, then retries with payment proof attached. All automatic, all in milliseconds.