The peyeeye.ai API

# Node / TypeScript
npm install peyeeye

export PEYEEYE_KEY="pk_live_51H…"

import { Peyeeye } from "peyeeye";
import Anthropic from "@anthropic-ai/sdk";

const peyeeye  = new Peyeeye({ apiKey: process.env.PEYEEYE_KEY });
const claude    = new Anthropic();

const shield = await peyeeye.shield();
const safe   = await shield.redact("Hi, I'm Ada, ada@a-e.com");

const reply = await claude.messages.create({
  model: "claude-sonnet-*",
  max_tokens: 256,
  messages: [{ role: "user", content: safe }]
});

console.log(await shield.rehydrate(reply.content[0].text));
// "Hi Ada, thanks — we've emailed ada@a-e.com."

Authorization: Bearer pk_live_51H…
Content-Type:    application/json
Idempotency-Key: req_a1b2c3d4   # optional, recommended

{
  "text": "Hi Ada, thanks — we've emailed ada@analytic-engines.com.",
  "replaced": 2,
  "unknown": [],
  "latency_ms": 11
}

X-RateLimit-Limit:      500
X-RateLimit-Remaining:  487
Retry-After:            0.42   # seconds, only on 429

{
  "id": "ORDER_ID",
  "kind": "regex",
  "pattern": "#A-\\d{6,}",
  "examples": ["#A-884217", "#A-007431"],
  "confidence_floor": 0.9
}

# POST /v1/redact/stream  body: { "chunks": ["Hi, I'm Ada", " — card 4242 4242 4242 4242"] }
event: session
data: {"session":"ses_7fA2kLw9MxPq"}

event: redacted
data: {"text":"Hi, I'm [PERSON_1]","entities":1}

event: redacted
data: {"text":" — card [CARD_1]","entities":1}

event: done
data: {"chars":37}

import { Peyeeye } from "peyeeye";
import Anthropic from "@anthropic-ai/sdk";

const peyeeye = new Peyeeye({ apiKey: process.env.PEYEEYE_KEY! });
const claude  = new Anthropic();

const shield = await peyeeye.shield();
const safe   = await shield.redact(userInput);

const upstream = await claude.messages.stream({
  model: "claude-sonnet-*",
  messages: [{ role: "user", content: safe }],
});

for await (const chunk of upstream) {
  if (chunk.type !== "content_block_delta") continue;
  const out = await shield.rehydrateChunk(chunk.delta.text);  // partial-token safe
  process.stdout.write(out);
}
process.stdout.write(await shield.flush());  // emit any buffered remainder

from peyeeye import Peyeeye
from anthropic import Anthropic
import os, sys

peyeeye = Peyeeye(api_key=os.environ["PEYEEYE_KEY"])
claude  = Anthropic()

with peyeeye.shield() as shield:
    safe = shield.redact(user_input)

    with claude.messages.stream(
        model="claude-sonnet-*",
        max_tokens=512,
        messages=[{"role": "user", "content": safe}],
    ) as upstream:
        for text in upstream.text_stream:
            sys.stdout.write(shield.rehydrate_chunk(text))  # partial-token safe
            sys.stdout.flush()

    sys.stdout.write(shield.flush())  # emit any buffered remainder

import { Peyeeye } from "peyeeye";

const peyeeye = new Peyeeye({ apiKey: process.env.PEYEEYE_KEY! });

for await (const ev of peyeeye.redactStream({
  chunks: ["Hi, I'm Ada", " — card 4242 4242 4242 4242"],
})) {
  if (ev.event === "session")  sessionId = ev.data.session;
  if (ev.event === "redacted") process.stdout.write(ev.data.text);
}

from peyeeye import Peyeeye

peyeeye = Peyeeye(api_key="pk_live_...")

for ev in peyeeye.redact_stream([
    "Hi, I'm Ada",
    " — card 4242 4242 4242 4242",
]):
    if ev.event == "session":
        session_id = ev.data["session"]
    elif ev.event == "redacted":
        print(ev.data["text"])

# npm, pnpm, yarn, or bun — pick your poison
npm install peyeeye
pnpm add peyeeye
bun add peyeeye

import { Peyeeye } from "peyeeye";
import Anthropic from "@anthropic-ai/sdk";

const peyeeye = new Peyeeye({ apiKey: process.env.PEYEEYE_KEY! });
const claude  = new Anthropic();

const shield = await peyeeye.shield();
const safe   = await shield.redact("Hi, I'm Ada, ada@a-e.com");

const reply = await claude.messages.create({
  model: "claude-sonnet-*",
  max_tokens: 256,
  messages: [{ role: "user", content: safe }],
});

console.log(await shield.rehydrate(reply.content[0].text));
// "Hi Ada, thanks — we've emailed ada@a-e.com."

new Peyeeye({
  apiKey: "pk_live_…",
  baseUrl: "https://api.peyeeye.ai",   // optional
  maxRetries: 3,                        // 429 + 5xx back off exponentially
  timeoutMs: 30_000,                    // per-request timeout
  defaultHeaders: { "X-App": "my-app" },
  fetch: globalThis.fetch,              // override on Cloudflare Workers
});

const r = await peyeeye.redact("Card: 4242 4242 4242 4242");
// r.redacted  → "Card: [CARD_1]"
// r.session   → "ses_…"
// r.entities  → [{ token: "[CARD_1]", type: "CARD", span: [6, 25], confidence: 0.99 }]

const back = await peyeeye.rehydrate("Confirmation for [CARD_1].", r.session);
// back.text → "Confirmation for 4242 4242 4242 4242."

# pip, poetry, pdm, uv — works with any installer
pip install peyeeye
poetry add peyeeye
uv pip install peyeeye

import os
from peyeeye import Peyeeye
from anthropic import Anthropic

peyeeye = Peyeeye(api_key=os.environ["PEYEEYE_KEY"])
claude  = Anthropic()

with peyeeye.shield() as shield:
    safe  = shield.redact("Hi, I'm Ada, ada@a-e.com")
    reply = claude.messages.create(
        model="claude-sonnet-*",
        max_tokens=256,
        messages=[{"role": "user", "content": safe}],
    )
    print(shield.rehydrate(reply.content[0].text))

from peyeeye import Peyeeye

peyeeye = Peyeeye(
    api_key="pk_live_...",
    base_url="https://api.peyeeye.ai",   # optional
    timeout=30.0,                         # per-request timeout (seconds)
    max_retries=3,                        # 429 + 5xx back off exponentially
    default_headers={"X-App": "my-app"},
)

r = peyeeye.redact("Card: 4242 4242 4242 4242")
# r.redacted  → "Card: [CARD_1]"
# r.session   → "ses_…"
# r.entities  → [DetectedEntity(token="[CARD_1]", type="CARD", span=(6, 25), confidence=0.99)]

back = peyeeye.rehydrate("Confirmation for [CARD_1].", session=r.session)
# back.text → "Confirmation for 4242 4242 4242 4242."

with peyeeye.shield(stateless=True) as shield:
    safe = shield.redact("Ada, 4242 4242 4242 4242")
    # shield.rehydration_key → "skey_AES-GCM-sealed..."
    # Shipped to a client, used later, no server-side state.
    print(shield.rehydrate("Hi [PERSON_1], your [CARD_1] is active."))

from peyeeye import PeyeeyeError

try:
    peyeeye.redact(text)
except PeyeeyeError as e:
    # e.status, e.code, e.message, e.request_id
    if e.code == "rate_limited":
        retry(e.retry_after)
    elif e.code == "forbidden":
        upgrade_plan()
    else:
        raise