Integration Guide

Learn how to integrate VaultProxy AI into your application in minutes.

1. Quick Start

VaultProxy is a drop-in proxy for OpenAI-compatible APIs. Just change the base URL and use your VaultProxy API key. All PII is automatically detected and anonymized before reaching the LLM provider.

bash
curl https://api.vaultproxy.ai/v1/chat/completions \
  -H "Authorization: Bearer vp_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-4.6-sonnet",
    "messages": [
      {"role": "user", "content": "Cześć, nazywam się Jan Kowalski, PESEL 85031501234"}
    ]
  }'

# Works with ANY model - just change the model field:
# "gpt-5.4", "google/gemini-2.5-flash", "groq/llama-4-scout", etc.
2. Python (OpenAI SDK)

Only two lines need to change in your existing OpenAI Python code: the base_url and api_key.

python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.vaultproxy.ai/v1",  # <- changed
    api_key="vp_your_api_key_here",            # <- changed
)

response = client.chat.completions.create(
    model="anthropic/claude-4.6-sonnet",  # Use ANY model via VaultProxy!
    messages=[
        {"role": "user", "content": "Przygotuj wycenę dla: Jan Kowalski, PESEL 85031501234, NIP 5261234567"}
    ],
)

# AI received: "Przygotuj wycenę dla: <PERSON_1>, PESEL <PESEL_1>, NIP <NIP_1>"
# Response is de-anonymized automatically with original data restored
print(response.choices[0].message.content)
3. JavaScript

Works with any HTTP client. Here is a plain fetch example:

javascript
const response = await fetch("https://api.vaultproxy.ai/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer vp_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "google/gemini-2.5-flash",  // Use any model
    messages: [
      { role: "user", content: "Klient: Jan Kowalski, tel. +48 123 456 789, ul. Marszałkowska 15, 00-001 Warszawa" },
    ],
  }),
});

const data = await response.json();
console.log(data.choices[0].message.content);
4. Available Models
Model IDProviderDescription
gpt-5.4OpenAIFlagship, 1M context, multimodal
gpt-5.4-miniOpenAIFast & cheap for batch processing
gpt-4oOpenAIPopular multimodal, fast
o1OpenAIReasoning model for code/math
anthropic/claude-4.6-opusAnthropicBest for complex reasoning
anthropic/claude-4.6-sonnetAnthropicBest price/quality for code
anthropic/claude-4.6-haikuAnthropicUltra-fast, simple tasks
google/gemini-3.1-proGoogleFlagship multimodal, 2M context
google/gemini-2.5-flashGoogleFast, great for batch
google/gemini-2.5-flash-liteGoogleCheapest Google option
mistral/mistral-large-3Mistral (EU)Flagship 675B MoE, RODO-friendly
mistral/mistral-small-4Mistral (EU)Fast with reasoning, 119B
groq/llama-4-scoutGroqLlama 4 with <100ms latency
groq/llama-4-maverickGroqLlama 4 for coding/long context
groq/deepseek-v3GroqGPT-level coding at 1/10 price
deepseek/deepseek-v3.2DeepSeekCheap coding, GPT-level
cohere/command-aCohere256k context, RAG/tools
xai/grok-4xAIPowerful, uncensored coding
perplexity/pplx-70b-onlinePerplexitySearch-enabled with citations
bielik/bielik-13b-proBielik (PL)Polish flagship, document analysis
bielik/bielik-7b-v2Bielik (PL)Polish-first, edge & RAG, RODO-friendly
5. PII Entity Types

The following PII entity types are supported. Each can be toggled on or off in the Settings page.

Entity TypeDescriptionExample
PERSONPerson names (imiona, nazwiska)Jan Kowalski → <PERSON_1>
EMAIL_ADDRESSEmail addresses[email protected] → <EMAIL_ADDRESS_1>
PHONE_NUMBERPhone numbers+48 123 456 789 → <PHONE_NUMBER_1>
PESELPolish national ID (PESEL)85031501234 → <PESEL_1>
NIPPolish tax ID (NIP)5261234567 → <NIP_1>
PL_ID_CARDDowód osobisty (ID card)ABC123456 → <PL_ID_CARD_1>
PL_PASSPORTPaszport (passport)AB1234567 → <PL_PASSPORT_1>
PL_ADDRESSStreet addressesul. Marszałkowska 15 → <PL_ADDRESS_1>
PL_POSTAL_CODEPostal codes (XX-XXX)00-001 → <PL_POSTAL_CODE_1>
DATE_OF_BIRTHDates of birth15.03.1985 → <DATE_OF_BIRTH_1>
IBAN_CODEBank account numbers (IBAN)PL 61 1090... → <IBAN_CODE_1>
CREDIT_CARDCredit/debit card numbers4111 1111 1111 1111 → <CREDIT_CARD_1>
REGONREGON (business registry)012345678 → <REGON_1>
ART.9 RODOSensitive data (health, religion, politics) - flagged, not anonymized"mam cukrzycę" → ⚠ SENSITIVE_HEALTH