Humanizer API docs

Authorization: Bearer ht_live_…
# or
x-api-key: ht_live_…

{
  "id": "hum_oJoMouByloZk",
  "object": "humanize",
  "output": "AI has changed how teams write. Work that took days now takes an afternoon.",
  "words_in": 16,
  "words_out": 15,
  "style": "business",
  "usage": {
    "words_used": 1240,
    "words_limit": 100000,
    "words_remaining": 98760,
    "period_end": "2026-11-30T08:25:17.000Z"
  },
  "request_id": "req_8e2d4f6a1b3c5d7e9f0a2b4c"
}

{
  "id": "det_a1B2c3D4e5F6",
  "object": "detect",
  "score": 93,
  "verdict": "ai",
  "human_score": 7,
  "ai_word_count": 44,
  "total_word_count": 44,
  "sentences": [
    { "text": "Artificial intelligence has fundamentally transformed the way modern organizations approach content creation.", "flagged": true },
    { "text": "By automating repetitive writing tasks, these systems enable teams to produce high-quality material at unprecedented speed.", "flagged": true },
    { "text": "Furthermore, they ensure consistency across channels while significantly reducing operational costs for businesses of every size.", "flagged": true }
  ],
  "usage": {
    "words_used": 1284,
    "words_limit": 100000,
    "words_remaining": 98716,
    "period_end": "2026-11-30T08:25:17.000Z"
  },
  "request_id": "req_3c5e7a9b1d3f5a7c9e1b3d5f"
}

{
  "object": "account",
  "email": "dev@example.com",
  "plan": { "id": "starter", "name": "Starter" },
  "key": {
    "id": "302a20f0-67ce-4507-a7ae-e272f633941b",
    "name": "Production",
    "prefix": "ht_live_Ab3x",
    "mode": "live",
    "scopes": ["humanize", "detect"],
    "created_at": "2026-10-30T09:12:44.000Z"
  },
  "limits": { "words_per_month": 100000, "trial_words": null, "max_words_per_request": 1500, "requests_per_minute": 30 },
  "period": { "start": "2026-10-30T08:25:17.000Z", "end": "2026-11-30T08:25:17.000Z" },
  "request_id": "req_e5bbc9b25e899a4dd055209e"
}

{
  "object": "usage",
  "plan": { "id": "starter", "name": "Starter" },
  "period": { "start": "2026-10-30T08:25:17.000Z", "end": "2026-11-30T08:25:17.000Z" },
  "words": { "used": 1284, "limit": 100000, "remaining": 98716 },
  "requests": { "period": 12 },
  "by_endpoint": {
    "humanize": { "requests": 9, "words": 1240 },
    "detect": { "requests": 1, "words": 44 }
  },
  "request_id": "req_c813a184dba46eed6b2dff78"
}

{
  "error": {
    "type": "billing_error",
    "code": "quota_exceeded",
    "message": "Your word quota for this billing period is exhausted.",
    "request_id": "req_e004dfec06a3b07a59d03767",
    "details": {
      "words_used": 100000,
      "words_limit": 100000,
      "period_end": "2026-11-30T08:25:17.000Z",
      "upgrade_url": "https://api.humanizertool.io/billing"
    }
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limited",
    "message": "Too many requests, please slow down.",
    "request_id": "req_13112eb48b2eb75ea30f53e2",
    "details": { "limit": 30, "retry_after": 44 }
  }
}

const API_BASE = "https://api.humanizertool.io/v1";
const API_KEY = process.env.HUMANIZER_API_KEY;

async function humanize(text, attempt = 0) {
  const res = await fetch(`${API_BASE}/humanize`, {
    method: "POST",
    headers: { Authorization: `Bearer ${API_KEY}`, "Content-Type": "application/json" },
    body: JSON.stringify({ text }),
    signal: AbortSignal.timeout(180_000),
  });
  if ((res.status === 429 || res.status === 503) && attempt < 3) {
    const wait = Number(res.headers.get("Retry-After")) || 2 ** attempt;
    await new Promise((r) => setTimeout(r, wait * 1000));
    return humanize(text, attempt + 1);
  }
  if (!res.ok) throw new Error((await res.json()).error.message);
  return res.json();
}

// const { output } = await humanize("Our new release makes it simple to manage invoices and share reports with your team.");