API Server

Self-host Chonkie as a REST API for language-agnostic text chunking

Run Chonkie as a self-hosted REST API and call any chunker or refinery from any language, framework, or HTTP client — no auth, no billing, no data leaving your infra.

Quick Start

Up and running in under a minute

Endpoints

All chunkers and refineries

Pipelines

Save and execute reusable chunking workflows

Docker

Container and production deployment

Why Use the API?

• Language-agnostic — call from JavaScript, Go, Ruby, or any HTTP client
• Self-hosted — your data never leaves your infrastructure
• Full feature parity — all Chonkie chunkers and refineries, over HTTP
• Batch support — chunk multiple documents in a single request
• No auth required — just run it and chunk away

Available Endpoints

Endpoint	Description
POST /v1/chunk/token	Fixed-size token windows
POST /v1/chunk/sentence	Sentence-boundary splitting
POST /v1/chunk/recursive	Structural/hierarchical splitting
POST /v1/chunk/semantic	Embedding-based semantic splitting
POST /v1/chunk/code	AST-aware code splitting
POST /v1/refine/overlap	Add overlap context to chunks
POST /v1/refine/embeddings	Attach embeddings to chunks
POST /v1/pipelines	Create a reusable pipeline
GET /v1/pipelines	List all pipelines
GET /v1/pipelines/{id}	Get a pipeline by ID
PUT /v1/pipelines/{id}	Update a pipeline
DELETE /v1/pipelines/{id}	Delete a pipeline
POST /v1/pipelines/{id}/execute	Execute a pipeline on text
GET /health	Health check
GET /	API info and available endpoints