TypeScript SDK

npm install classer-ai

import { classify } from "classer-ai";

// Uses CLASSER_API_KEY environment variable
const result = await classify({
  text: "I can't log in",
  labels: ["billing", "technical", "sales"]
});

console.log(result.label);      // "technical"
console.log(result.confidence); // 0.94

export CLASSER_API_KEY=your-api-key

import { ClasserClient } from "classer-ai";

const client = new ClasserClient({
  apiKey: "your-api-key",
  baseUrl: "https://api.classer.ai"  // optional
});

const result = await client.classify({
  text: "I can't log in to my account",
  labels: ["billing", "technical", "sales"],
  descriptions: {                             // optional
    billing: "Payment or invoice issues",
    technical: "Login, bugs, errors",
    sales: "Pricing or plan questions",
  },
  model: "qwen",                              // optional (default: "qwen")
});

result.label        // "technical"
result.confidence   // 0.94
result.tokens       // 142
result.latency_ms   // 87
result.cached       // false

const result = await client.classify({
  text: "I can't log in",
  classifier: "support-tickets",       // or "support-tickets@v2"
});

const result = await client.tag({
  text: "Breaking: Tech stocks surge amid AI boom",
  labels: ["politics", "technology", "finance", "sports"],
  threshold: 0.3,                              // optional (default: 0.3)
  descriptions: { technology: "Tech industry news" },  // optional
  model: "qwen",                               // optional
});

for (const t of result.labels) {
  console.log(`${t.label}: ${t.confidence}`);
}
// technology: 0.92
// finance: 0.78

result.tokens       // 200
result.latency_ms   // 203
result.cached       // false

import { classify, tag } from "classer-ai";

const result = await classify({ text: "...", labels: ["a", "b"] });
const tagged = await tag({ text: "...", labels: ["a", "b"], threshold: 0.5 });

import { ClasserClient, ClasserError } from "classer-ai";

const client = new ClasserClient({ apiKey: "your-key" });

try {
  const result = await client.classify({
    text: "Hello",
    labels: ["greeting", "question"]
  });
} catch (error) {
  if (error instanceof ClasserError) {
    console.log(`Error: ${error.message}`);
    console.log(`Status: ${error.status}`);    // HTTP status code
    console.log(`Detail: ${error.detail}`);    // Error detail from the API
  }
}

interface ClassifyRequest {
  text: string;
  labels?: string[];
  classifier?: string;
  descriptions?: Record<string, string>;
  model?: string;
}

interface ClassifyResponse {
  label?: string;
  confidence?: number;
  tokens: number;
  latency_ms: number;
  cached: boolean;
}

interface TagRequest {
  text: string;
  labels?: string[];
  classifier?: string;
  descriptions?: Record<string, string>;
  model?: string;
  threshold?: number;  // default: 0.3
}

interface TagLabel {
  label: string;
  confidence: number;
}

interface TagResponse {
  labels: TagLabel[];  // empty array when nothing matches
  tokens: number;
  latency_ms: number;
  cached: boolean;
}

class ClasserError extends Error {
  status?: number;
  detail?: string;
}