A small guide to
getting started.

import { randomUUID } from "node:crypto";
import { existsSync, readFileSync } from "node:fs";

// Read settings from a .env file in this folder, if there is one. Real environment variables win.
if (existsSync(".env")) {
  for (const line of readFileSync(".env", "utf8").split(/\r?\n/)) {
    const match = line.match(/^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*?)\s*$/);
    if (match && process.env[match[1]] === undefined) process.env[match[1]] = match[2].replace(/^(["'])(.*)\1$/, "$2");
  }
}

function setting(name, what) {
  const value = process.env[name];
  if (!value || value.startsWith("paste-your-")) {
    console.error(`Set ${name} to ${what}, in .env or your environment.`);
    process.exit(1);
  }
  return value;
}
const key = setting("HATE_API_KEY", "your HateAPI key");
const baseUrl = (process.env.HATE_API_BASE_URL ?? "https://api.hateapi.com").replace(/\/$/, "");

const response = await fetch(`${baseUrl}/v1/classifications`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${key}`,
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({
    "content": {
      "type": "text",
      "text": "Wishing our Jewish friends a peaceful holiday.",
      "language": "en"
    },
    "options": {
      "inference_provider": "addresshate",
      "model": "AddressHate/AH-Qwen3.5-4B-Antisemitism",
      "prompt_variant": "frozen"
    }
  }),
  signal: AbortSignal.timeout(130_000),
});
const text = await response.text();
if (!response.ok) {
  console.error(`HateAPI returned HTTP ${response.status}: ${text}`);
  process.exit(1);
}
console.log(JSON.stringify(JSON.parse(text), null, 2));

import json
import os
import sys
import urllib.error
import urllib.request
import uuid

# Read settings from a .env file in this folder, if there is one. Real environment variables win.
if os.path.exists(".env"):
    with open(".env", encoding="utf-8") as env_file:
        for line in env_file:
            name, sep, value = line.strip().partition("=")
            if sep and name.strip() and not name.strip().startswith("#"):
                os.environ.setdefault(name.strip(), value.strip().strip("\"'"))


def setting(name, what):
    value = os.environ.get(name, "")
    if not value or value.startswith("paste-your-"):
        sys.exit(f"Set {name} to {what}, in .env or your environment.")
    return value


headers = {
    "Authorization": "Bearer " + setting("HATE_API_KEY", "your HateAPI key"),
    "Content-Type": "application/json",
    "Idempotency-Key": str(uuid.uuid4()),
}
base_url = os.environ.get("HATE_API_BASE_URL", "https://api.hateapi.com").rstrip("/")
payload = json.loads("{\"content\":{\"type\":\"text\",\"text\":\"Wishing our Jewish friends a peaceful holiday.\",\"language\":\"en\"},\"options\":{\"inference_provider\":\"addresshate\",\"model\":\"AddressHate/AH-Qwen3.5-4B-Antisemitism\",\"prompt_variant\":\"frozen\"}}")

request = urllib.request.Request(
    base_url + "/v1/classifications",
    data=json.dumps(payload).encode("utf-8"),
    headers=headers,
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=130) as response:
        print(json.dumps(json.load(response), indent=2))
except urllib.error.HTTPError as error:
    sys.exit(f"HateAPI returned HTTP {error.code}: {error.read().decode('utf-8', 'replace')}")

import { randomUUID } from "node:crypto";
import { existsSync, readFileSync } from "node:fs";

// Read settings from a .env file in this folder, if there is one. Real environment variables win.
if (existsSync(".env")) {
  for (const line of readFileSync(".env", "utf8").split(/\r?\n/)) {
    const match = line.match(/^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*?)\s*$/);
    if (match && process.env[match[1]] === undefined) process.env[match[1]] = match[2].replace(/^(["'])(.*)\1$/, "$2");
  }
}

function setting(name, what) {
  const value = process.env[name];
  if (!value || value.startsWith("paste-your-")) {
    console.error(`Set ${name} to ${what}, in .env or your environment.`);
    process.exit(1);
  }
  return value;
}
const key = setting("HATE_API_KEY", "your HateAPI key");
const providerKey = setting("HATE_PROVIDER_API_KEY", "your provider's API key");
const baseUrl = (process.env.HATE_API_BASE_URL ?? "https://api.hateapi.com").replace(/\/$/, "");

const response = await fetch(`${baseUrl}/v1/classifications`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${key}`,
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
    "X-Provider-API-Key": providerKey,
  },
  body: JSON.stringify({
    "content": {
      "type": "text",
      "text": "Wishing our Jewish friends a peaceful holiday.",
      "language": "en"
    },
    "options": {
      "inference_provider": "openrouter_decisions",
      "model": "openai/gpt-6-luna-decisions",
      "prompt_variant": "brief"
    }
  }),
  signal: AbortSignal.timeout(130_000),
});
const text = await response.text();
if (!response.ok) {
  console.error(`HateAPI returned HTTP ${response.status}: ${text}`);
  process.exit(1);
}
console.log(JSON.stringify(JSON.parse(text), null, 2));