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 ID | Provider | Description |
|---|---|---|
| gpt-5.4 | OpenAI | Flagship, 1M context, multimodal |
| gpt-5.4-mini | OpenAI | Fast & cheap for batch processing |
| gpt-4o | OpenAI | Popular multimodal, fast |
| o1 | OpenAI | Reasoning model for code/math |
| anthropic/claude-4.6-opus | Anthropic | Best for complex reasoning |
| anthropic/claude-4.6-sonnet | Anthropic | Best price/quality for code |
| anthropic/claude-4.6-haiku | Anthropic | Ultra-fast, simple tasks |
| google/gemini-3.1-pro | Flagship multimodal, 2M context | |
| google/gemini-2.5-flash | Fast, great for batch | |
| google/gemini-2.5-flash-lite | Cheapest Google option | |
| mistral/mistral-large-3 | Mistral (EU) | Flagship 675B MoE, RODO-friendly |
| mistral/mistral-small-4 | Mistral (EU) | Fast with reasoning, 119B |
| groq/llama-4-scout | Groq | Llama 4 with <100ms latency |
| groq/llama-4-maverick | Groq | Llama 4 for coding/long context |
| groq/deepseek-v3 | Groq | GPT-level coding at 1/10 price |
| deepseek/deepseek-v3.2 | DeepSeek | Cheap coding, GPT-level |
| cohere/command-a | Cohere | 256k context, RAG/tools |
| xai/grok-4 | xAI | Powerful, uncensored coding |
| perplexity/pplx-70b-online | Perplexity | Search-enabled with citations |
| bielik/bielik-13b-pro | Bielik (PL) | Polish flagship, document analysis |
| bielik/bielik-7b-v2 | Bielik (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 Type | Description | Example |
|---|---|---|
| PERSON | Person names (imiona, nazwiska) | Jan Kowalski → <PERSON_1> |
| EMAIL_ADDRESS | Email addresses | [email protected] → <EMAIL_ADDRESS_1> |
| PHONE_NUMBER | Phone numbers | +48 123 456 789 → <PHONE_NUMBER_1> |
| PESEL | Polish national ID (PESEL) | 85031501234 → <PESEL_1> |
| NIP | Polish tax ID (NIP) | 5261234567 → <NIP_1> |
| PL_ID_CARD | Dowód osobisty (ID card) | ABC123456 → <PL_ID_CARD_1> |
| PL_PASSPORT | Paszport (passport) | AB1234567 → <PL_PASSPORT_1> |
| PL_ADDRESS | Street addresses | ul. Marszałkowska 15 → <PL_ADDRESS_1> |
| PL_POSTAL_CODE | Postal codes (XX-XXX) | 00-001 → <PL_POSTAL_CODE_1> |
| DATE_OF_BIRTH | Dates of birth | 15.03.1985 → <DATE_OF_BIRTH_1> |
| IBAN_CODE | Bank account numbers (IBAN) | PL 61 1090... → <IBAN_CODE_1> |
| CREDIT_CARD | Credit/debit card numbers | 4111 1111 1111 1111 → <CREDIT_CARD_1> |
| REGON | REGON (business registry) | 012345678 → <REGON_1> |
| ART.9 RODO | Sensitive data (health, religion, politics) - flagged, not anonymized | "mam cukrzycę" → ⚠ SENSITIVE_HEALTH |