Skip to Content
Introduction

Introduction

Fylor is an API platform for AI agents to perform file operations — PDF compression, image resizing, video transcoding, format conversion, and more. Each operation is billed per-use via MPP  (Machine Payments Protocol), so your agent negotiates price and pays programmatically over HTTP.

Who is this for

Fylor is built for autonomous agents that need to process files as part of their workflows:

  • E-commerce agents — product image resizing, thumbnail generation, PDF invoice creation
  • Back-office agents — document conversion (DOCX/XLSX to PDF), compression for archival, PDF merging
  • Design & creative agents — watermarking, format conversion, batch image processing
  • Content pipeline agents — video compression, format transcoding, automated media workflows
  • Customer support agents — compressing attachments, converting screenshots, merging ticket documents
  • Legal & compliance agents — PDF splitting for redaction, document conversion for archival, metadata stripping
  • And any other agent that needs to process files programmatically

How it works

Every Fylor endpoint uses the HTTP 402 payment flow:

  1. Your agent sends a request to a Fylor endpoint (e.g. POST /pdf/compress)
  2. The gateway returns HTTP 402 with a payment challenge containing the price
  3. Your agent’s MPP client negotiates and pays
  4. Fylor processes the file and returns the result with a payment receipt

Available operations

EndpointDescriptionPrice
POST /pdf/compressCompress PDF files$0.01 flat
POST /pdf/convertConvert documents to PDF$0.018 flat
POST /pdf/mergeMerge multiple PDFs$0.01 flat
POST /pdf/splitSplit or extract PDF pages$0.01 flat
POST /image/compressCompress images$0.012 flat
POST /image/convertConvert image formats$0.012 flat
POST /image/resizeResize images$0.012 flat
POST /image/watermark/addAdd text or logo watermarks$0.012 flat
POST /video/convertConvert video formats$0.0003/MB
POST /video/compressCompress videos$0.0003/MB
POST /audio/convertConvert audio formats$0.0003/MB
POST /audio/compressCompress audio files$0.0003/MB

Quickstart

1. Install Tempo and set up your wallet

Fylor uses MPP  (Machine Payments Protocol) for per-operation billing. The easiest way to get started is with Tempo , which handles payments automatically.

# Install Tempo
curl -sSf https://tempo.fm/install | sh
 
# Install the wallet and request extensions
tempo add wallet
tempo add request
 
# Log in and fund your wallet
tempo wallet login
tempo wallet fund

See the Tempo wallet setup guide  for detailed instructions.

2. Make your first request

Use tempo request as a drop-in replacement for curl — it automatically handles the HTTP 402 payment challenge:

# Compress a PDF
tempo request -X POST https://api.fylor.com/pdf/compress \
  -F "file=@document.pdf" \
  -F "quality=ebook" \
  -o compressed.pdf
# Resize an image
tempo request -X POST https://api.fylor.com/image/resize \
  -F "file=@photo.jpg" \
  -F "width=800" \
  -F "fit=cover" \
  -o resized.jpg

When your agent sends a request, Tempo intercepts the 402 Payment Required response, negotiates the price, pays, and returns the processed file — all in one round trip.

Learn more

Last updated on
PDF