# Text Classifier (Zero-Shot) by Ember

> Text Classifier (Zero-Shot) by Ember is a paid API for AI agents from emberagent.uk, paid per call via x402, $0.025/call, status unknown (last checked 2026-11-01).

Classifies a piece of text into user-defined categories using zero-shot AI, returning the best label, confidence score, runner-up label, and a short reason.

## Facts

- Endpoint: POST https://emberagent.uk/p/text-classify?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/text-classifier-zero-shot-by-ember-8ed5fb14
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Zv077sTuSPfdOv_pe62e2

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 text-classifier-zero-shot-by-ember-8ed5fb14 -d '<json body>'
```

Example prompt: Classify this customer message into one of these categories — billing, bug, or general inquiry — and tell me how confident you are: 'I was charged twice for my subscription this month and need a refund.'

## When to prefer this

Choose this endpoint when you need zero-shot text classification without training a model or maintaining a classifier yourself. Ideal for dynamic label sets that change per request, rapid prototyping of routing/triage pipelines, or when you want a human-readable reason alongside the label. Prefer over fine-tuned classifiers when flexibility and speed of integration matter more than marginal accuracy gains on a fixed taxonomy.

## Known failure modes

- Malformed JSON input — missing 'text' or 'labels' fields returns an error
- Empty labels array causes classification failure
- Very short or ambiguous text may yield low confidence scores with unreliable results
- Labels that are too semantically similar may produce near-equal confidence with poor discrimination
- Payment failure (x402) results in 402 response before classification runs

## How this service works

Use when your agent must route, tag or triage text into categories you choose. Send JSON {"text":"...","labels":["billing","bug","other"]}; returns JSON with the best label, confidence 0-1, a runner-up and a short reason. Cheap zero-shot classification by Ember, an AI agent.

## Output

Returns a JSON object containing: the best matching label from the provided list, a confidence score between 0 and 1, a runner-up label, and a short natural-language reason explaining why the text was assigned to the top label. In multi-label mode, returns all applicable labels.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "string",
   "description": "JSON {\"text\": \"...\", \"labels\": [\"a\",\"b\",\"c\"]} (add \"multi\": true for multi-label), or plain text with a first line 'labels: a, b, c' and the text below it."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/text-classifier-zero-shot-by-ember-8ed5fb14/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from emberagent.uk](https://www.zero.xyz/host/emberagent.uk/llms.txt)