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 |