# Vextorium Text Chunker (trocear-texto)

> Vextorium Text Chunker (trocear-texto) is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-09).

Splits long text into overlapping chunks for RAG pipelines and embedding workflows, supporting character, word, or token-based splitting while respecting sentence or paragraph boundaries.

## Facts

- Endpoint: POST https://api.vextorium.com/trocear-texto-pago?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-09
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-text-chunker-trocear-texto-fdd8576a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QlbZOtcCE1b_XcMTYfyHm

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vextorium-text-chunker-trocear-texto-fdd8576a -d '<json body>'
```

Example prompt: Split this 50,000-word article into chunks of 1000 characters with a 100-character overlap, keeping sentences whole, and tell me each chunk's position and estimated token count.

## When to prefer this

Choose this endpoint when you need structured, position-aware text chunking with metadata (character counts, word counts, estimated token counts, start positions) for RAG or embedding pipelines. It is especially useful when boundary-respecting chunking (sentence or paragraph level) is required and when overlap control is needed. Prefer over manual splitting when you need token estimation or multi-unit flexibility (characters, words, tokens) in a single API call.

## Known failure modes

- Text exceeds 2,000,000 character limit — request rejected
- Chunk size outside 50–100,000 range — validation error
- Missing required 'texto' field — 400 bad request
- Invalid enum value for 'unidad' or 'respetar' — schema validation error
- Empty text input — may return zero chunks or error

## How this service works

Split long text into overlapping chunks for RAG and embeddings, by characters, words or estimated tokens, keeping sentences or paragraphs whole, with each chunk's position and size.

## Output

Returns a JSON object with an array of chunk objects, each containing the chunk text, its index, start character position, word count, character count, and estimated token count. Also returns the total character count, number of fragments, configured chunk size, overlap, and the unit and boundary mode used.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "texto"
     ],
     "properties": {
      "texto": {
       "type": "string",
       "description": "Text (up to 2,000,000 characters)"
      },
      "solape": {
       "type": "integer",
       "description": "Overlap (default 100)"
      },
      "tamano": {
       "type": "integer",
       "description": "Chunk size (50-100000, default 1000)"
      },
      "unidad": {
       "enum": [
        "caracteres",
        "palabras",
        "tokens"
       ],
       "type": "string"
      },
      "respetar": {
       "enum": [
        "frases",
        "parrafos",
        "palabras"
       ],
       "type": "string"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "nota": {
       "type": [
        "string",
        "null"
       ]
      },
      "solape": {
       "type": [
        "number",
        "null"
       ]
      },
      "tamano": {
       "type": [
        "number",
        "null"
       ]
      },
      "trozos": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "texto": {
          "type": [
           "null",
           "string"
          ]
         },
         "indice": {
          "type": [
           "null",
           "number"
          ]
         },
         "inicio": {
          "type": [
           "null",
           "number"
          ]
         },
         "palabras": {
          "type": [
           "null",
           "number"
          ]
         },
         "caracteres": {
          "type": [
           "null",
           "number"
          ]
         },
         "tokens_estimados": {
          "type": [
           "null",
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "nota": "Tokens estimados (~4 caracteres por token); el valor exacto depende del modelo.",
  "solape": 20,
  "tamano": 80,
  "trozos": [
   {
    "texto": "First sentence of the document. Second sentence with more detail.",
    "indice": 0,
    "inicio": 0,
    "palabras": 10,
    "caracteres": 65,
    "tokens_estimados": 16
   },
   {
    "texto": "Third sentence closes the idea. A new paragraph starts here.",
    "indice": 1,
    "inicio": 66,
    "palabras": 10,
    "caracteres": 60,
    "tokens_estimados": 15
   },
   {
    "texto": "It keeps going for a while.",
    "indice": 2,
    "inicio": 127,
    "palabras": 6,
    "caracteres": 27,
    "tokens_estimados": 7
   }
  ],
  "unidad": "caracteres",
  "respetar": "frases",
  "fragmentos": 3,
  "caracteres_totales": 154
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-text-chunker-trocear-texto-fdd8576a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)