# SperaxOS Batch Text Classifier

> SperaxOS Batch Text Classifier is a paid API for AI agents from chat.sperax.io, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-20).

Classifies an array of text items into predefined risk/intelligence categories (conflict, cyber, economic, etc.) using a selectable LLM, payable per-call with USDC via x402

## Facts

- Endpoint: POST https://chat.sperax.io/api/x402/classify-batch?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/speraxos-batch-text-classifier-83580d6e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KZjqOrcLxrNfW-JDvCGC5

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 speraxos-batch-text-classifier-83580d6e -d '<json body>'
```

Example prompt: Classify these 5 news snippets into categories like conflict, cyber, economic, military, and geopolitical using the llama-3.3-70b-versatile model: [snippet1, snippet2, snippet3, snippet4, snippet5]. Pay the $0.02 USDC fee per the x402 protocol.

## When to prefer this

Choose this endpoint when you need to classify multiple texts (up to 50) in a single API call without managing an API key, prefer paying per-use with USDC on Base, and need DeFi/geopolitical intelligence-focused categorization with a choice of Groq-hosted open-source LLMs.

## Known failure modes

- Payment not included or insufficient USDC: 402 Payment Required response
- texts array empty or exceeds 50 items: validation error
- Invalid model enum value: schema validation failure
- Categories array exceeds 20 items: rejected
- Network or LLM inference timeout for large batches
- USDC balance insufficient on Base network

## How this service works

AI-powered DeFi intelligence APIs payable via the x402 HTTP payment protocol. No API key required — pay per request with USDC on Base. Identity-only (SIWX) endpoints are free for wallets with an agentcash identity.

## Output

Returns classification results for each input text item, mapping each string to one or more of the specified categories (e.g. conflict, cyber, economic, energy, environment, geopolitical, military, political, social, technology) as determined by the selected LLM.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "model": {
   "enum": [
    "llama-3.1-8b-instant",
    "llama-3.3-70b-versatile",
    "llama3-8b-8192",
    "llama3-70b-8192",
    "mixtral-8x7b-32768",
    "gemma2-9b-it"
   ],
   "type": "string",
   "default": "llama-3.1-8b-instant"
  },
  "texts": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 50,
   "minItems": 1
  },
  "categories": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "default": [
    "conflict",
    "cyber",
    "economic",
    "energy",
    "environment",
    "geopolitical",
    "military",
    "political",
    "social",
    "technology"
   ],
   "maxItems": 20
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/speraxos-batch-text-classifier-83580d6e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chat.sperax.io](https://www.zero.xyz/host/chat.sperax.io/llms.txt)