Mimari Genel Bakış
LexicalLayer, istemciniz ile model sağlayıcısı (OpenAI, Anthropic, yerel vLLM) arasına giren bağımsız bir yüksek hızlı ters vekildir. Gelen istekleri aynen upstream sağlayıcıya iletir, dönen token akışını Speculative Stream Pipeline ile filtreler.
Paket Yöneticileri ve Kurulum
İhtiyacınıza göre Node.js SDK, Python Client veya tek satırda çalışan Model Context Protocol (MCP) paketini kurabilirsiniz.
API Anahtarları & Yetkilendirme
LexicalLayer isteklerini yetkilendirmek için konsolunuzdan ürettiğiniz lx_live_ veya lx_test_ anahtarını X-Lexical-Key başlığı altında veya SDK istemcisinde gönderin.
• Zero-Retention: API anahtarlarınız veya token verileriniz hiçbir zaman diske yazılmaz ya da loglanmaz.
Reverse Proxy (0-Code Değişikliği)
Mevcut OpenAI resmi kütüphanesinde yalnızca baseURL parametresini LexicalLayer Gateway'ine yönlendirin. Kodunuzun geri kalanını aynen koruyun.
// OpenAI Resmi Kütüphanesini Değiştirmeden Kullanın
import OpenAI from "openai";
const openai = new OpenAI({
baseURL: "https://gateway.lexicallayer.com/v1", // Sadece baseURL yönlendirin
apiKey: process.env.OPENAI_API_KEY, // Kendi API anahtarınız
defaultHeaders: {
"X-Lexical-Key": process.env.LEXICAL_KEY, // LexicalLayer lisans anahtarı
"X-Lexical-Blueprint": "founder", // Ton: founder | engineer | minimalist
"X-Lexical-Deslop": "aggressive", // Filtre düzeyi: strict | aggressive
},
});
const response = await openai.chat.completions.create({
model: "gpt-4",
messages: [{ role: "user", content: "Yatırımcılara hitaben şirket güncellemesi yaz." }],
stream: true,
});Node / TypeScript SDK (@lexicallayer/sdk)
Resmi @lexicallayer/sdk paketi, kalibre edilmiş LoRA ağırlıklarınızı (.safetensors ve steering vektörlerini) doğrudan AI agent'larınıza ve OpenAI istemcilerinize tek satırda bağlar.
import OpenAI from "openai";
import { LexicalLayer } from "@lexicallayer/sdk";
// LexicalLayer motorunu tanımlayın (varsayılan: http://127.0.0.1:8001 veya Cloud)
const lexical = new LexicalLayer({
baseUrl: process.env.LEXICAL_BASE_URL || "http://127.0.0.1:8001",
agentName: "my-coding-agent",
});
const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
// OpenAI client'ı kullanıcının anti-slop & LoRA ağırlıklarıyla sarın
const steeredOpenAI = lexical.wrapOpenAI(openai);
// Normal chat completion çağrısı — arkaplanda bilişsel katman ve kurallar devrede
const response = await steeredOpenAI.chat.completions.create({
model: "gpt-4o",
messages: [
{ role: "user", content: "Bu modülün mimarisini nasıl kuralım?" }
],
});
console.log(response.choices[0].message.content);import { LexicalLayer } from "@lexicallayer/sdk";
const lexical = new LexicalLayer();
// Doğrudan üretim ve steering metrikleri
const res = await lexical.generate({
prompt: "Sistem durumunu ve mimari yaklaşımı açıkla.",
useUserWeights: true, // .safetensors ağırlıklarını uygular
});
console.log(res.output);
console.log(res.metrics); // { lora_rank_applied: 16, fluff_tokens_suppressed: 18 }
// Aktif Adapter Bilgilerini Çekme (vLLM / Ollama için)
const adapter = await lexical.getCalibratedAdapter();
console.log("Aktif Adapter:", adapter.adapterFilename); // 'user_steered_rank16.safetensors'Python Async Client
Python veri bilimi, LangChain veya LlamaIndex boru hatlarınızda sıfır konfigürasyonla çalışın.
# pip install lexicallayer
from lexicallayer import LexicalMiddleware, Blueprint
import openai
import os
client = openai.OpenAI(
base_url="https://gateway.lexicallayer.com/v1",
api_key=os.environ.get("OPENAI_API_KEY"),
default_headers={
"X-Lexical-Key": os.environ.get("LEXICAL_KEY"),
"X-Lexical-Blueprint": Blueprint.FOUNDER,
"X-Lexical-Strictness": "0.95"
}
)
response = client.chat.completions.create(
model="gpt-4",
messages=[{"role": "user", "content": "Ürün lansman bülteni hazırla."}]
)
print(response.choices[0].message.content)Model Context Protocol (MCP) Kurulumu
Cursor IDE veya Claude Desktop üzerinden kod yazarken veya prompt üretirken sentetik yapay zeka yorumlarını engellemek için yerel MCP sunucusunu çalıştırın.
{
"mcpServers": {
"lexicallayer": {
"command": "npx",
"args": ["-y", "@lexicallayer/mcp", "--blueprint", "engineer"]
}
}
}Blueprint Header Parametreleri ve Konfigürasyon
Gateway'e gönderilen her HTTP isteğinde aşağıdaki başlıklarla (headers) davranışı anlık olarak kontrol edebilirsiniz:
Özel Şirket Sözlüğü API
Kendi kurumsal terminolojinizi, marka kılavuzunuzu ve kurum içi yasaklı ifadeleri REST endpointi üzerinden dinamik olarak yükleyip yönetin.
// POST https://gateway.lexicallayer.com/v1/dictionaries
curl -X POST https://gateway.lexicallayer.com/v1/dictionaries \
-H "Authorization: Bearer lx_live_9f81a74e" \
-H "Content-Type: application/json" \
-d '{
"name": "Acme Corp Brand Shield",
"banned_tokens": ["game-changer", "synergize", "tapestry", "beacon"],
"required_replacements": {
"utilize": "use",
"facilitate": "help"
},
"strict_mode": true
}'Server-Sent Events (SSE) Canlı Token Akışı
LexicalLayer, stream: true parametresiyle çalışan tüm sorgularda sliding window n-gram token buffer tekniğini kullanır. Model çıktı üretirken tokenlar 1-2 kelimelik tampon bellekten geçer ve son kullanıcıya sıfır hissedilen gecikmeyle (TTFT + 4ms) akar.
Hata Kodları & Telemetri Standartları
Ağ veya model kesintilerinde hata zarfı (error envelope) RFC 7807 uyumlu JSON olarak döner. Uygulamanız asla sessizce çökmez.