API Documentation // x402 Protocol
> TABLE_OF_CONTENTS
Overview Pricing Tiers Authentication & Payments API Endpoints Response Format Error Handling

Overview

CHUNKER.CC is an AI-native document chunking API with micropayments on Solana. Upload documents and receive semantically chunked text optimized for RAG pipelines and LLM context windows.

BASE URL:
https://api.adepti.cc
FRONTEND:
https://chunker.cc
NETWORK:
Solana Mainnet
PAYMENT:
USDC via Phantom

Pricing.Matrix

DEMO
FREE
Quality: 6/10
100 pages/day limit
STANDARD
$0.001
Quality: 7.5/10
RECOMMENDED
PROFESSIONAL
$0.008
Quality: 9/10
Context injection

Authentication

Demo Tier (Free)

No authentication required. Simply POST your file to the endpoint.

Paid Tiers (Standard & Professional)

Requires USDC payment on Solana. Payment flow:

  1. Connect Phantom wallet to the web interface
  2. Send USDC to the payment address (automatic)
  3. Transaction signature is included in X-PAYMENT header
  4. Backend verifies payment on-chain before processing
PAYMENT HEADER FORMAT:

X-PAYMENT: <solana-transaction-signature>

The signature is the base58-encoded transaction ID returned by Phantom after signing the USDC transfer.

API.Endpoints

GET / FREE

Returns API info, pricing, and configuration.

curl https://api.adepti.cc/
GET /health FREE

Health check endpoint for monitoring.

curl https://api.adepti.cc/health

// Response
{ "status": "healthy", "network": "solana-mainnet" }
POST /chunk/demo FREE

Basic recursive character chunking. Limited to 100 pages/day.

Parameter Type Description
fileREQUIRED File Document to chunk (.txt, .pdf)
curl -X POST https://api.adepti.cc/chunk/demo \
  -F "file=@document.txt"

Response.Format

All chunking endpoints return the same response structure:

{
  "success": true,
  "tier": "standard",
  "total_chunks": 12,
  "metadata": {
    "filename": "document.txt",
    "content_type": "text/plain",
    "size_bytes": 15420,
    "estimated_pages": 3
  },
  "chunks": [
    {
      "text": "First chunk content...",
      "metadata": {
        "chunk_index": 0,
        "char_count": 1024
      }
    },
    {
      "text": "Second chunk content...",
      "metadata": {
        "chunk_index": 1,
        "char_count": 987
      }
    }
  ],
  "payment": {
    "amount": 1000,
    "asset": "USDC",
    "network": "solana-mainnet"
  }
}

Error.Handling

Code Status Description
200 Success Request processed successfully
400 Bad Request Invalid file format, encoding, or corrupted PDF
402 Payment Required Missing or invalid payment for paid tier
500 Server Error Internal processing error

402 Payment Required Response

{
  "error": "Payment Required",
  "paymentRequirements": {
    "x402Version": 1,
    "scheme": "exact",
    "network": "solana-mainnet",
    "maxAmountRequired": "1000",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "payTo": "8hTm...dWT",
    "description": "Standard tier sentence-aware chunking"
  }
}