Split text into semantically meaningful chunks

The context-aware splitting endpoint provides intelligent text splitting capabilities for documents up to 4000 words. Unlike simple character-based splitting, context-aware splitting preserves the semantic meaning and context between chunks, making it ideal for processing long-form content while maintaining coherence.

​

Use cases

• Breaking down long articles or research papers for improved readability
• Preparing content for chunked processing in RAG (Retrieval-Augmented Generation) systems
• Splitting lengthy legal documents while maintaining context around clauses and references
• Creating digestible sections of educational content while preserving logical flow
• Processing large documentation files for knowledge base creation

​

Endpoint overview

URL: POST https://api.writer.com/v1/tools/context-aware-splitting

curl --location 'https://api.writer.com/v1/tools/context-aware-splitting' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $WRITER_API_KEY" \
--data '{
  "text": "text to split",
  "strategy": "llm_split"
}'

​

Request body

The request body includes the following parameters:

​

Splitting strategies

• llm_split: Uses an LLM for precise semantic splitting
• fast_split: Uses heuristic-based approach for quick splitting
• hybrid_split: Combines both approaches

​

Response format

Returns an array of text chunks, with at least one chunk guaranteed. Each chunk maintains semantic coherence while preserving the context of the original text.

{
  "chunks": ["chunk1", "chunk2", "chunk3"]
}