https://api.raipii.com

curl -X POST https://api.raipii.com/v1/sanitize \
  -H "Authorization: Bearer ps_live_..." \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello John Smith"}'

import raipii, openai

ps = raipii.Raipii(api_key="ps_live_...")
oai = openai.OpenAI()

prompt = "Help John Smith (john@acme.com, SSN 392-45-7810) with his claim."

# 1. Sanitize — strip PII before sending to your LLM
result = ps.sanitize(prompt, mode="fake_substitute")
# → "Help Michael Torres (m.torres@email.net, SSN 847-23-1956)..."

# 2. Call your LLM with clean text
reply = oai.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": result.sanitized_text}],
).choices[0].message.content

# 3. Restore original values in the response
final = ps.restore(reply, result.session_id)
print(final.restored_text)  # John Smith's real data is back

{
  "session_id": "ps_sess_abc123...",
  "conversation_id": null,
  "sanitized_text": "Call [PERSON_1] at [EMAIL_1]",
  "entities_found": [
    {
      "type": "PERSON",
      "original": "John Smith",
      "replacement": "[PERSON_1]",
      "position": [5, 15],
      "confidence": 0.99
    },
    {
      "type": "EMAIL",
      "original": "john@acme.com",
      "replacement": "[EMAIL_1]",
      "position": [19, 32],
      "confidence": 1.0
    }
  ],
  "char_count": 32,
  "usage": { "chars_billed": 32 }
}

{
  "restored_text": "Call John Smith at john@acme.com",
  "substitutions_reversed": 2,
  "usage": { "chars_billed": 32 }
}

{
  "entities_found": [
    {
      "type": "US_SSN",
      "value": "392-45-7810",
      "confidence": 1.0,
      "position": [10, 21],
      "detection_method": "structured"
    }
  ],
  "pii_detected": true,
  "risk_level": "HIGH",
  "usage": { "chars_billed": 21 }
}

{
  "conversation_id": "ps_conv_xyz...",
  "expires_at": "2026-04-11T12:00:00"
}

conv = ps.conversations.create(ttl=3600)

# Turn 1 — "John Smith" → "Michael Torres"
turn1 = ps.sanitize(
    "My name is John Smith.",
    mode="fake_substitute",
    conversation_id=conv.conversation_id,
)

# Turn 2 — "John Smith" → same "Michael Torres" from turn 1
turn2 = ps.sanitize(
    "Tell me more about John Smith.",
    mode="fake_substitute",
    conversation_id=conv.conversation_id,
)

{ "error": "Monthly character limit exceeded" }

from openai import OpenAI

client = OpenAI(
    base_url="https://api.raipii.com/v1/proxy/openai",
    api_key="ignored",          # raipii handles auth
    default_headers={
        "Authorization": "Bearer ps_live_...",   # your raipii key
        "X-LLM-API-Key": "sk-...",               # your OpenAI key
    },
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Help John Smith (SSN 392-45-7810)"}],
)
# PII was never sent to OpenAI — response has original values restored

import anthropic

client = anthropic.Anthropic(
    base_url="https://api.raipii.com/v1/proxy/anthropic",
    api_key="ignored",
    default_headers={
        "Authorization": "Bearer ps_live_...",
        "X-LLM-API-Key": "sk-ant-...",
    },
)

message = client.messages.create(
    model="claude-opus-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Help John Smith (SSN 392-45-7810)"}],
)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.raipii.com/v1/proxy/openai",
  apiKey: "ignored",
  defaultHeaders: {
    Authorization: "Bearer ps_live_...",
    "X-LLM-API-Key": "sk-...",
  },
});

const response = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [{ role: "user", content: "Help John Smith (SSN 392-45-7810)" }],
});

pip install raipii

import raipii

ps = raipii.Raipii(api_key="ps_live_...")  # or RAIPII_API_KEY env var

result   = ps.sanitize("John Smith, john@acme.com", mode="fake_substitute")
restored = ps.restore(llm_response, result.session_id)
detected = ps.detect("SSN 392-45-7810")
conv     = ps.conversations.create(ttl=3600)

npm install raipii

import { Raipii } from "raipii";

const ps = new Raipii({ apiKey: "ps_live_..." }); // or RAIPII_API_KEY env var

const result   = await ps.sanitize("John Smith, john@acme.com", { mode: "fake_substitute" });
const restored = await ps.restore(llmResponse, result.sessionId);
const detected = await ps.detect("SSN 392-45-7810");
const conv     = await ps.conversations.create({ ttl: 3600 });

# Sanitize
curl -X POST https://api.raipii.com/v1/sanitize \
  -H "Authorization: Bearer ps_live_..." \
  -H "Content-Type: application/json" \
  -d '{"text": "John Smith, john@acme.com", "mode": "fake_substitute"}'

# Restore
curl -X POST https://api.raipii.com/v1/restore \
  -H "Authorization: Bearer ps_live_..." \
  -H "Content-Type: application/json" \
  -d '{"text": "...", "session_id": "ps_sess_..."}'

# Detect
curl -X POST https://api.raipii.com/v1/detect \
  -H "Authorization: Bearer ps_live_..." \
  -H "Content-Type: application/json" \
  -d '{"text": "My SSN is 392-45-7810"}'