x402 Micropayment Protocol Active

Sleek File Conversions
Powered by AI Micropayments

An asynchronous, HTTP 402 compliant gateway offering developer-first file signature analysis and conversion. Programmatically process documents up to 40 MB in seconds.

x402.json Standardized micropayment configuration & gateway metadata. agent.json Discovery specification mapping agent capabilities. Documentation Explore sample client codes and SDK wrappers.

API Endpoint Reference

GET /api/x402/v1/health
Check the operational status of the conversion gateway.
Response
{
  "status": "healthy",
  "service": "convert-guru-x402",
  "timestamp": 1782393240
}
POST /api/x402/v1/detect-file-type
Analyze base64 header bytes and name to detect file format.
Request Headers
API-Key: <YOUR_INTERNAL_API_KEY>
Content-Type: application/json
Request Body
{
  "filename": "document.docx",
  "header_first_200_bytes_base64": "UEsDBBQAAAAIAN...",
  "size_bytes": 10240
}
POST /api/x402/v1/convert-file
Initiate file conversion. Accepts multipart file upload and target format.
Response (202 Accepted)
{
  "job_id": "job_S2t4S3M5TjdoOTFhMnMzNTRm",
  "status": "processing",
  "status_url": "https://convert.guru/api/x402/v1/convert-file/job_S2t4S3M5TjdoOTFhMnMzNTRm/status",
  "retry_after_seconds": 5,
  "message": "Conversion started. Poll status_url until status is done or failed."
}
GET /api/x402/v1/convert-file/{job_id}/status
Poll status of a running conversion job. Returns 402 payment requirements on completion.
Completed Response (HTTP 200)
{
  "job_id": "job_S2t4S3M5TjdoOTFhMnMzNTRm",
  "status": "done",
  "detected_input_format": "docx",
  "target_format": "pdf",
  "input_file_size_bytes": 10240,
  "result_available": true,
  "result_requires_payment": true,
  "price_for_result": {
    "amount": "0.020000",
    "currency": "USDC",
    "atomic_units": "20000",
    "decimals": 6,
    "network": "eip155:8453",
    "pricing_rule": "file_size_lte_10mb"
  },
  "result_url": "https://convert.guru/api/x402/v1/convert-file/job_S2t4S3M5TjdoOTFhMnMzNTRm/result",
  "price_expires_at": "2026-05-22T15:51:44Z"
}
DELETE /api/x402/v1/convert-file/{job_id}/delete
Instantly clean up and remove upload files and job details from the server.
Response
{
  "success": true,
  "message": "Converted file and job details deleted successfully."
}

Protocol & Lifecycle

⚡

Asynchronous Task Isolation

When a file is submitted, the gateway records the task configuration, starts an isolated background runner, and yields control instantly with a 202 Accepted. Webserver workers are never blocked.

💎

Base Network Settlements

Conversions require a USDC micropayment on the Base network (Layer 2). Pricing is calculated dynamically: $0.02 for files up to 10 MB, and $0.04 for files up to 40 MB.

🛡️

Strict Ephemerality

Uploaded input documents and output files are held in sandboxed temporary caches on the gateway server. Issuing a DELETE command immediately wipes all trace of the job data from disks.

Agentic Usage

This endpoint has been customized to comply with autonomous LLM developers. AI agents can read the JSON specs to configure client libraries, sign transactions, and perform multi-format file operations without manual setup.

Example curl flow
# 1. Start Job
curl -X POST https://convert.guru/api/x402/v1/convert-file \
  -H "API-Key: your_key" \
  -F "[email protected]" \
  -F "target_format=pdf"

# 2. Check Status
curl https://convert.guru/api/x402/v1/convert-file/job_XYZ/status