OmniRoute/docs/i18n/tr/docs/CODEBASE_DOCUMENTATION.md

omniroute — Codebase Documentation (Türkçe)

🌐 Languages: 🇺🇸 English · 🇪🇸 es · 🇫🇷 fr · 🇩🇪 de · 🇮🇹 it · 🇷🇺 ru · 🇨🇳 zh-CN · 🇯🇵 ja · 🇰🇷 ko · 🇸🇦 ar · 🇮🇳 hi · 🇮🇳 in · 🇹🇭 th · 🇻🇳 vi · 🇮🇩 id · 🇲🇾 ms · 🇳🇱 nl · 🇵🇱 pl · 🇸🇪 sv · 🇳🇴 no · 🇩🇰 da · 🇫🇮 fi · 🇵🇹 pt · 🇷🇴 ro · 🇭🇺 hu · 🇧🇬 bg · 🇸🇰 sk · 🇺🇦 uk-UA · 🇮🇱 he · 🇵🇭 phi · 🇧🇷 pt-BR · 🇨🇿 cs · 🇹🇷 tr

---

omnirouteçok sağlayıcılı AI proxy yönlendiricisine yönelik kapsamlı, başlangıç ​​seviyesi dostu bir kılavuz.---

1. What Is omniroute?

omniroute, AI istemcileri (Claude CLI, Codex, Cursor IDE vb.) ile AI sağlayıcıları (Anthropic, Google, OpenAI, AWS, GitHub vb.) arasında bulunan birproxy yönlendiricisidir. Büyük bir sorunu çözüyor:

**Farklı AI istemcileri farklı "diller" (API formatları) konuşur ve farklı AI sağlayıcıları da farklı "diller" bekler.**omniroute bunlar arasında otomatik olarak çeviri yapar.

Bunu Birleşmiş Milletler'deki evrensel bir tercüman gibi düşünün; her delege herhangi bir dili konuşabilir ve tercüman bunu diğer delegeler için çevirir.---

2. Architecture Overview

graph LR
    subgraph Clients
        A[Claude CLI]
        B[Codex]
        C[Cursor IDE]
        D[OpenAI-compatible]
    end

    subgraph omniroute
        E[Handler Layer]
        F[Translator Layer]
        G[Executor Layer]
        H[Services Layer]
    end

    subgraph Providers
        I[Anthropic Claude]
        J[Google Gemini]
        K[OpenAI / Codex]
        L[GitHub Copilot]
        M[AWS Kiro]
        N[Antigravity]
        O[Cursor API]
    end

    A --> E
    B --> E
    C --> E
    D --> E
    E --> F
    F --> G
    G --> I
    G --> J
    G --> K
    G --> L
    G --> M
    G --> N
    G --> O
    H -.-> E
    H -.-> G

Core Principle: Hub-and-Spoke Translation

Tüm format çevirilerihub olarak OpenAI formatındangeçer:``` Client Format → [OpenAI Hub] → Provider Format (request) Provider Format → [OpenAI Hub] → Client Format (response)

Bu,**N²**(her çift) yerine yalnızca**N çevirmene**(format başına bir tane) ihtiyacınız olduğu anlamına gelir.---

## 3. Project Structure

omniroute/ ├── open-sse/ ← Core proxy library (portable, framework-agnostic) │ ├── index.js ← Main entry point, exports everything │ ├── config/ ← Configuration & constants │ ├── executors/ ← Provider-specific request execution │ ├── handlers/ ← Request handling orchestration │ ├── services/ ← Business logic (auth, models, fallback, usage) │ ├── translator/ ← Format translation engine │ │ ├── request/ ← Request translators (8 files) │ │ ├── response/ ← Response translators (7 files) │ │ └── helpers/ ← Shared translation utilities (6 files) │ └── utils/ ← Utility functions ├── src/ ← Application layer (Express/Worker runtime) │ ├── app/ ← Web UI, API routes, middleware │ ├── lib/ ← Database, auth, and shared library code │ ├── mitm/ ← Man-in-the-middle proxy utilities │ ├── models/ ← Database models │ ├── shared/ ← Shared utilities (wrappers around open-sse) │ ├── sse/ ← SSE endpoint handlers │ └── store/ ← State management ├── data/ ← Runtime data (credentials, logs) │ └── provider-credentials.json (external credentials override, gitignored) └── tester/ ← Test utilities

---

## 4. Module-by-Module Breakdown

### 4.1 Config (`open-sse/config/`)

Tüm sağlayıcı yapılandırmaları için**tek gerçek kaynak**.

| Dosya | Amaç |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 'sabitler.ts' | Her sağlayıcı için temel URL'ler, OAuth kimlik bilgileri (varsayılanlar), başlıklar ve varsayılan sistem istemlerini içeren "PROVIDERS" nesnesi. Ayrıca "HTTP_STATUS", "ERROR_TYPES", "COOLDOWN_MS", "BACKOFF_CONFIG" ve "SKIP_PATTERNS" öğelerini de tanımlar. |
| `credentialLoader.ts' | "data/provider-credentials.json"dan harici kimlik bilgilerini yükler ve bunları "PROVIDERS" içindeki sabit kodlanmış varsayılanlar üzerinden birleştirir. Geriye dönük uyumluluğu korurken sırları kaynak kontrolünün dışında tutar.               |
| 'providerModels.ts' | Merkezi model kaydı: sağlayıcı takma adlarını eşler → model kimlikleri. `getModels()`, `getProviderByAlias()` gibi işlevler.                                                                                                          |
| `codexInstructions.ts` | Codex isteklerine eklenen sistem talimatları (kısıtlamaları düzenleme, sanal alan kuralları, onay politikaları).                                                                                                                 |
| 'defaultThinkingSignature.ts' | Claude ve Gemini modelleri için varsayılan "düşünme" imzaları.                                                                                                                                                               |
| `ollamaModels.ts` | Yerel Ollama modelleri için şema tanımı (isim, boyut, aile, nicemleme).                                                                                                                                             |#### Credential Loading Flow

```mermaid
flowchart TD
    A["App starts"] --> B["constants.ts defines PROVIDERS\nwith hardcoded defaults"]
    B --> C{"data/provider-credentials.json\nexists?"}
    C -->|Yes| D["credentialLoader reads JSON"]
    C -->|No| E["Use hardcoded defaults"]
    D --> F{"For each provider in JSON"}
    F --> G{"Provider exists\nin PROVIDERS?"}
    G -->|No| H["Log warning, skip"]
    G -->|Yes| I{"Value is object?"}
    I -->|No| J["Log warning, skip"]
    I -->|Yes| K["Merge clientId, clientSecret,\ntokenUrl, authUrl, refreshUrl"]
    K --> F
    H --> F
    J --> F
    F -->|Done| L["PROVIDERS ready with\nmerged credentials"]
    E --> L

---

4.2 Executors (open-sse/executors/)

YürütücülerStrateji Modelikullanaraksağlayıcıya özel mantığıkapsüller. Her yürütücü gerektiğinde temel yöntemleri geçersiz kılar.```mermaid classDiagram class BaseExecutor { +buildUrl(model, stream, options) +buildHeaders(credentials, stream, body) +transformRequest(body, model, stream, credentials) +execute(url, options) +shouldRetry(status, error) +refreshCredentials(credentials, log) }

class DefaultExecutor {
    +refreshCredentials()
}

class AntigravityExecutor {
    +buildUrl()
    +buildHeaders()
    +transformRequest()
    +shouldRetry()
    +refreshCredentials()
}

class CursorExecutor {
    +buildUrl()
    +buildHeaders()
    +transformRequest()
    +parseResponse()
    +generateChecksum()
}

class KiroExecutor {
    +buildUrl()
    +buildHeaders()
    +transformRequest()
    +parseEventStream()
    +refreshCredentials()
}

BaseExecutor <|-- DefaultExecutor
BaseExecutor <|-- AntigravityExecutor
BaseExecutor <|-- CursorExecutor
BaseExecutor <|-- KiroExecutor
BaseExecutor <|-- CodexExecutor
BaseExecutor <|-- GeminiCLIExecutor
BaseExecutor <|-- GithubExecutor

| Yürütücü | Sağlayıcı | Anahtar Uzmanlıklar |
| ---------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| 'base.ts' | — | Özet tabanı: URL oluşturma, başlıklar, yeniden deneme mantığı, kimlik bilgileri yenileme |
| 'varsayılan.ts' | Claude, İkizler, OpenAI, GLM, Kimi, MiniMax | Standart sağlayıcılar için genel OAuth belirteci yenilemesi |
| 'antigravity.ts' | Google Bulut Kodu | Proje/oturum kimliği oluşturma, çoklu URL geri dönüşü, hata mesajlarından özel yeniden ayrıştırma denemesi ("2 saat 7 dakika 23 saniye sonra sıfırlama") |
| imleç.ts | İmleç IDE'si |**En karmaşık**: SHA-256 sağlama toplamı kimlik doğrulaması, Protobuf istek kodlaması, ikili EventStream → SSE yanıt ayrıştırma |
| 'codex.ts' | OpenAI Kodeksi | Sistem talimatlarını enjekte eder, düşünme seviyelerini yönetir, desteklenmeyen parametreleri kaldırır |
| 'gemini-cli.ts' | Google İkizler CLI | Özel URL oluşturma (`streamGenerateContent`), Google OAuth belirteci yenileme |
| github.ts | GitHub Yardımcı Pilotu | Çift jeton sistemi (GitHub OAuth + Copilot jetonu), VSCode üstbilgisini taklit eden |
| kiro.ts | AWS CodeWhisperer | AWS EventStream ikili ayrıştırma, AMZN olay çerçeveleri, belirteç tahmini |
| 'index.ts' | — | Fabrika: harita sağlayıcı adı → yürütücü sınıfı, varsayılan geri dönüş ile |---

### 4.3 Handlers (`open-sse/handlers/`)

**Orkestrasyon katmanı**— çeviriyi, yürütmeyi, akışı ve hata işlemeyi koordine eder.

| Dosya | Amaç |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 'chatCore.ts' |**Merkezi orkestratör**(~600 satır). İstek yaşam döngüsünün tamamını yönetir: format algılama → çeviri → yürütücü gönderimi → akışlı/akışsız yanıt → belirteç yenileme → hata işleme → kullanım günlüğü. |
| `responsesHandler.ts` | OpenAI'nin Yanıt API'si için Bağdaştırıcı: Yanıt formatını dönüştürür → Sohbet Tamamlamalarını → `chatCore'a gönderir → SSE'yi tekrar Yanıt formatına dönüştürür.                                                                        |
| 'embeddings.ts' | Gömme oluşturma işleyicisi: yerleştirme modelini çözer → sağlayıcı, sağlayıcı API'sine gönderir, OpenAI uyumlu yerleştirme yanıtını döndürür. 6+ sağlayıcıyı destekler.                                                    |
| `imageGeneration.ts' | Görüntü oluşturma işleyicisi: görüntü modelini çözer → sağlayıcı, OpenAI uyumlu, Gemini görüntüsü (Antigravity) ve geri dönüş (Nebius) modlarını destekler. Base64 veya URL resimlerini döndürür.                                          |#### Request Lifecycle (chatCore.ts)

```mermaid
sequenceDiagram
    participant Client
    participant chatCore
    participant Translator
    participant Executor
    participant Provider

    Client->>chatCore: Request (any format)
    chatCore->>chatCore: Detect source format
    chatCore->>chatCore: Check bypass patterns
    chatCore->>chatCore: Resolve model & provider
    chatCore->>Translator: Translate request (source → OpenAI → target)
    chatCore->>Executor: Get executor for provider
    Executor->>Executor: Build URL, headers, transform request
    Executor->>Executor: Refresh credentials if needed
    Executor->>Provider: HTTP fetch (streaming or non-streaming)

    alt Streaming
        Provider-->>chatCore: SSE stream
        chatCore->>chatCore: Pipe through SSE transform stream
        Note over chatCore: Transform stream translates<br/>each chunk: target → OpenAI → source
        chatCore-->>Client: Translated SSE stream
    else Non-streaming
        Provider-->>chatCore: JSON response
        chatCore->>Translator: Translate response
        chatCore-->>Client: Translated JSON
    end

    alt Error (401, 429, 500...)
        chatCore->>Executor: Retry with credential refresh
        chatCore->>chatCore: Account fallback logic
    end

---

4.4 Services (open-sse/services/)

İşleyicileri ve yürütücüleri destekleyen iş mantığı.	File	Purpose
provider.ts	Format detection (detectFormat): analyzes request body structure to identify Claude/OpenAI/Gemini/Antigravity/Responses formats (includes max_tokens heuristic for Claude). Also: URL building, header building, thinking config normalization. Supports openai-compatible-* and anthropic-compatible-* dynamic providers.
model.ts	Model string parsing (claude/model-name → {provider: "claude", model: "model-name"}), alias resolution with collision detection, input sanitization (rejects path traversal/control chars), and model info resolution with async alias getter support.
accountFallback.ts	Rate-limit handling: exponential backoff (1s → 2s → 4s → max 2min), account cooldown management, error classification (which errors trigger fallback vs. not).
tokenRefresh.ts	OAuth token refresh for every provider: Google (Gemini, Antigravity), Claude, Codex, Qwen, Qoder, GitHub (OAuth + Copilot dual-token), Kiro (AWS SSO OIDC + Social Auth). Includes in-flight promise deduplication cache and retry with exponential backoff.
combo.ts	Combo models: chains of fallback models. If model A fails with a fallback-eligible error, try model B, then C, etc. Returns actual upstream status codes.
usage.ts	Fetches quota/usage data from provider APIs (GitHub Copilot quotas, Antigravity model quotas, Codex rate limits, Kiro usage breakdowns, Claude settings).
accountSelector.ts	Smart account selection with scoring algorithm: considers priority, health status, round-robin position, and cooldown state to pick the optimal account for each request.
contextManager.ts	Request context lifecycle management: creates and tracks per-request context objects with metadata (request ID, timestamps, provider info) for debugging and logging.
ipFilter.ts	IP-based access control: supports allowlist and blocklist modes. Validates client IP against configured rules before processing API requests.
sessionManager.ts	Session tracking with client fingerprinting: tracks active sessions using hashed client identifiers, monitors request counts, and provides session metrics.
signatureCache.ts	Request signature-based deduplication cache: prevents duplicate requests by caching recent request signatures and returning cached responses for identical requests within a time window.
systemPrompt.ts	Global system prompt injection: prepends or appends a configurable system prompt to all requests, with per-provider compatibility handling.
thinkingBudget.ts	Reasoning token budget management: supports passthrough, auto (strip thinking config), custom (fixed budget), and adaptive (complexity-scaled) modes for controlling thinking/reasoning tokens.
wildcardRouter.ts	Wildcard model pattern routing: resolves wildcard patterns (e.g., */claude-*) to concrete provider/model pairs based on availability and priority.

Token Refresh Deduplication

sequenceDiagram
    participant R1 as Request 1
    participant R2 as Request 2
    participant Cache as refreshPromiseCache
    participant OAuth as OAuth Provider

    R1->>Cache: getAccessToken("gemini", token)
    Cache->>Cache: No in-flight promise
    Cache->>OAuth: Start refresh
    R2->>Cache: getAccessToken("gemini", token)
    Cache->>Cache: Found in-flight promise
    Cache-->>R2: Return existing promise
    OAuth-->>Cache: New access token
    Cache-->>R1: New access token
    Cache-->>R2: Same access token (shared)
    Cache->>Cache: Delete cache entry

Account Fallback State Machine

stateDiagram-v2
    [*] --> Active
    Active --> Error: Request fails (401/429/500)
    Error --> Cooldown: Apply backoff
    Cooldown --> Active: Cooldown expires
    Active --> Active: Request succeeds (reset backoff)

    state Error {
        [*] --> ClassifyError
        ClassifyError --> ShouldFallback: Rate limit / Auth / Transient
        ClassifyError --> NoFallback: 400 Bad Request
    }

    state Cooldown {
        [*] --> ExponentialBackoff
        ExponentialBackoff: Level 0 = 1s
        ExponentialBackoff: Level 1 = 2s
        ExponentialBackoff: Level 2 = 4s
        ExponentialBackoff: Max = 2min
    }

Combo Model Chain

flowchart LR
    A["Request with\ncombo model"] --> B["Model A"]
    B -->|"2xx Success"| C["Return response"]
    B -->|"429/401/500"| D{"Fallback\neligible?"}
    D -->|Yes| E["Model B"]
    D -->|No| F["Return error"]
    E -->|"2xx Success"| C
    E -->|"429/401/500"| G{"Fallback\neligible?"}
    G -->|Yes| H["Model C"]
    G -->|No| F
    H -->|"2xx Success"| C
    H -->|"Fail"| I["All failed →\nReturn last status"]

---

4.5 Translator (open-sse/translator/)

Kendi kendini kaydeden bir eklenti sistemi kullananbiçim çeviri motoru.#### Mimari

graph TD
    subgraph "Request Translation"
        A["Claude → OpenAI"]
        B["Gemini → OpenAI"]
        C["Antigravity → OpenAI"]
        D["OpenAI Responses → OpenAI"]
        E["OpenAI → Claude"]
        F["OpenAI → Gemini"]
        G["OpenAI → Kiro"]
        H["OpenAI → Cursor"]
    end

    subgraph "Response Translation"
        I["Claude → OpenAI"]
        J["Gemini → OpenAI"]
        K["Kiro → OpenAI"]
        L["Cursor → OpenAI"]
        M["OpenAI → Claude"]
        N["OpenAI → Antigravity"]
        O["OpenAI → Responses"]
    end

Dizin	Dosyalar	Açıklama
'istek/'	8 çevirmen	İstek gövdelerini formatlar arasında dönüştürün. Her dosya, içe aktarma sırasında 'register(from, to, fn)' aracılığıyla kendi kendine kaydolur.
'yanıt/'	7 çevirmen	Akışlı yanıt parçalarını formatlar arasında dönüştürün. SSE olay türlerini, düşünme bloklarını ve araç çağrılarını yönetir.
'yardımcılar/'	6 yardımcı	Paylaşılan yardımcı programlar: "claudeHelper" (sistem istemi çıkarma, düşünme yapılandırması), "geminiHelper" (parça/içerik eşleme), "openaiHelper" (format filtreleme), "toolCallHelper" (kimlik oluşturma, eksik yanıt ekleme), "maxTokensHelper", "responsesApiHelper".
'index.ts'	—	Çeviri motoru: translateRequest(), translateResponse(), durum yönetimi, kayıt defteri.
'formatlar.ts'	—	Biçim sabitleri: OPENAI, CLAUDE, GEMINI, ANTIGRAVITY, KIRO, CURSOR, OPENAI_RESPONSES.	#### Key Design: Self-Registering Plugins

// Each translator file calls register() on import:
import { register } from "../index.js";
register("claude", "openai", translateClaudeToOpenAI);

// The index.js imports all translator files, triggering registration:
import "./request/claude-to-openai.js"; // ← self-registers

---

4.6 Utils (open-sse/utils/)

Dosya	Amaç
'hata.ts'	Hata yanıtı oluşturma (OpenAI uyumlu format), yukarı akış hata ayrıştırma, hata mesajlarından Antigravity yeniden deneme süresi çıkarma, SSE hata akışı.
'stream.ts'	SSE Dönüşüm Akışı— çekirdek akış hattı. İki mod: "TRANSLATE" (tam format çeviri) ve "PASSTHROUGH" (kullanımı normalleştirme + ayıklama). Parça ara belleğe almayı, kullanım tahminini ve içerik uzunluğu izlemeyi yönetir. Akış başına kodlayıcı/kod çözücü örnekleri, paylaşılan durumdan kaçınır.
'streamHelpers.ts'	Düşük seviyeli SSE yardımcı programları: "parseSSELine" (boşluk toleranslı), "hasValuableContent" (OpenAI/Claude/Gemini için boş parçaları filtreler), "fixInvalidId", "formatSSE" ("perf_metrics" temizliği ile formata duyarlı SSE serileştirme).
'usageTracking.ts'	Herhangi bir formattan (Claude/OpenAI/Gemini/Responses) jeton kullanımı çıkarma, jeton başına ayrı araç/mesaj karakter oranlarıyla tahmin, arabellek ekleme (2000 jeton güvenlik marjı), formata özel alan filtreleme, ANSI renkleriyle konsol günlüğü kaydı.
requestLogger.ts	Legacy file-based request logging helper kept for compatibility. Current deployments should prefer APP_LOG_TO_FILE for application logs and the call log pipeline for persisted request artifacts.
'bypassHandler.ts'	Claude CLI'den belirli kalıpları (başlık çıkarma, ısınma, sayım) yakalar ve herhangi bir sağlayıcıyı aramadan sahte yanıtlar döndürür. Hem akışı hem de akış dışını destekler. Kasıtlı olarak Claude CLI kapsamıyla sınırlıdır.
'ağProxy.ts'	Belirli bir sağlayıcı için giden proxy URL'sini öncelik sırasına göre çözer: sağlayıcıya özel yapılandırma → genel yapılandırma → ortam değişkenleri (HTTPS_PROXY/HTTP_PROXY/ALL_PROXY). 'NO_PROXY' hariç tutmalarını destekler. 30'lu yıllar için önbellek yapılandırması.	#### SSE Streaming Pipeline

flowchart TD
    A["Provider SSE stream"] --> B["TextDecoder\n(per-stream instance)"]
    B --> C["Buffer lines\n(split on newline)"]
    C --> D["parseSSELine()\n(trim whitespace, parse JSON)"]
    D --> E{"Mode?"}
    E -->|TRANSLATE| F["translateResponse()\ntarget → OpenAI → source"]
    E -->|PASSTHROUGH| G["fixInvalidId()\nnormalize chunk"]
    F --> H["hasValuableContent()\nfilter empty chunks"]
    G --> H
    H -->|"Has content"| I["extractUsage()\ntrack token counts"]
    H -->|"Empty"| J["Skip chunk"]
    I --> K["formatSSE()\nserialize + clean perf_metrics"]
    K --> L["TextEncoder\n(per-stream instance)"]
    L --> M["Enqueue to\nclient stream"]

    style A fill:#f9f,stroke:#333
    style M fill:#9f9,stroke:#333

Request Logger Session Structure

logs/
└── claude_gemini_claude-sonnet_20260208_143045/
    ├── 1_req_client.json      ← Raw client request
    ├── 2_req_source.json      ← After initial conversion
    ├── 3_req_openai.json      ← OpenAI intermediate format
    ├── 4_req_target.json      ← Final target format
    ├── 5_res_provider.txt     ← Provider SSE chunks (streaming)
    ├── 5_res_provider.json    ← Provider response (non-streaming)
    ├── 6_res_openai.txt       ← OpenAI intermediate chunks
    ├── 7_res_client.txt       ← Client-facing SSE chunks
    └── 6_error.json           ← Error details (if any)

---

4.7 Application Layer (src/)

Dizin	Amaç
'src/app/'	Web kullanıcı arayüzü, API yolları, Ekspres ara katman yazılımı, OAuth geri arama işleyicileri
'src/lib/'	Veritabanı erişimi (localDb.ts, usageDb.ts), kimlik doğrulama, paylaşımlı
'src/mitm/'	Sağlayıcı trafiğini ele geçirmek için ortadaki adam proxy yardımcı programları
'src/models/'	Veritabanı modeli tanımları
'kaynak/paylaşılan/'	open-sse işlevlerinin etrafındaki sarmalayıcılar (sağlayıcı, akış, hata vb.)
src/sse/	open-sse kitaplığını Ekspres rotalara bağlayan SSE uç nokta işleyicileri
src/mağaza/	Uygulama durumu yönetimi	#### Notable API Routes

Rota	Yöntemler	Amaç
/api/provider-models	AL/GÖNDER/SİL	Sağlayıcı başına özel modeller için CRUD
/api/models/catalog	AL	Sağlayıcıya göre gruplandırılmış tüm modellerin (sohbet, yerleştirme, resim, özel) toplu kataloğu
/api/settings/proxy	AL/PUT/SİL	Hiyerarşik giden proxy yapılandırması (genel/sağlayıcılar/kombinasyonlar/anahtarlar)
/api/settings/proxy/test	YAYIN	Proxy bağlantısını doğrular ve genel IP/gecikme süresini döndürür
/v1/providers/[sağlayıcı]/sohbet/tamamlamalar	YAYIN	Model doğrulamayla sağlayıcı başına özel sohbet tamamlamaları
/v1/providers/[provider]/embeddings	YAYIN	Model doğrulamayla sağlayıcı başına özel yerleştirmeler
/v1/providers/[provider]/images/jenerasyonlar	YAYIN	Model doğrulamayla sağlayıcı başına özel görüntü oluşturma
/api/settings/ip-filter	AL/koy	IP izin verilenler listesi/engellenenler listesi yönetimi
/api/settings/thinking-budget	AL/koy	Belirteç bütçesinin akıl yürütme yapılandırması (geçişli/otomatik/özel/uyarlanabilir)
/api/settings/system-prompt	AL/koy	Tüm istekler için küresel sistem istemi ekleme
/api/sessions	AL	Aktif oturum takibi ve ölçümleri
/api/hız-limitleri	AL	Hesap başına oran sınırı durumu	---

5. Key Design Patterns

5.1 Hub-and-Spoke Translation

Tüm formatlarhub olarak OpenAI formatıaracılığıyla çevrilir. Yeni bir sağlayıcı eklemek, N çift değil, yalnızcabir çiftçevirmen (OpenAI'ye/OpenAI'den) yazmayı gerektirir.### 5.2 Executor Strategy Pattern

Her sağlayıcının 'BaseExecutor'dan devralınan özel bir yürütücü sınıfı vardır. 'executors/index.ts' dosyasındaki fabrika, çalışma zamanında doğru olanı seçer.### 5.3 Self-Registering Plugin System

Çevirmen modülleri içe aktarma sırasında kendilerini 'register()' yoluyla kaydeder. Yeni bir çevirmen eklemek sadece bir dosya oluşturup onu içe aktarmaktır.### 5.4 Account Fallback with Exponential Backoff

Bir sağlayıcı 429/401/500 döndürdüğünde, sistem üstel bekleme süreleri uygulayarak (1 sn → 2 sn → 4 sn → maksimum 2 dakika) bir sonraki hesaba geçebilir.### 5.5 Combo Model Chains

Bir "kombo", birden fazla "sağlayıcı/model" dizesini gruplandırır. İlki başarısız olursa otomatik olarak bir sonrakine geri dönün.### 5.6 Stateful Streaming Translation

Yanıt çevirisi, "initState()" mekanizması aracılığıyla SSE parçaları (düşünme bloğu izleme, araç çağrısı birikimi, içerik bloğu indeksleme) genelinde durumu korur.### 5.7 Usage Safety Buffer

İstemcilerin sistem istemleri ve biçim çevirisinden kaynaklanan ek yük nedeniyle bağlam penceresi sınırlarına ulaşmasını önlemek için bildirilen kullanıma 2000 jetonlu bir arabellek eklenir.---

6. Supported Formats

Biçim	Yön	Tanımlayıcı
OpenAI Sohbet Tamamlamaları	kaynak + hedef	'açık'
OpenAI Yanıtlar API'sı	kaynak + hedef	'açık yanıtlar'
Antropik Claude	kaynak + hedef	'Claude'
Google İkizler	kaynak + hedef	'İkizler'
Google İkizler CLI	yalnızca hedef	'İkizler-cli'
Yer çekimine karşı	kaynak + hedef	'yerçekimine karşı'
AWS Kiro	yalnızca hedef	'kiro'
İmleç	yalnızca hedef	'imleç'	---

7. Supported Providers

Sağlayıcı	Kimlik Doğrulama Yöntemi	Yürütücü	Önemli Notlar
Antropik Claude	API anahtarı veya OAuth	Varsayılan	'x-api-key' başlığını kullanır
Google İkizler	API anahtarı veya OAuth	Varsayılan	'x-goog-api-key' başlığını kullanır
Google İkizler CLI	OAuth	GeminiCLI	'streamGenerateContent' uç noktasını kullanır
Yer çekimine karşı	OAuth	Yer çekimine karşı	Çoklu URL geri dönüşü, özel ayrıştırmayı yeniden deneme
OpenAI	API anahtarı	Varsayılan	Standart Taşıyıcı yetkilendirmesi
Kodeks	OAuth	Kodeks	Sistem talimatlarını enjekte eder, düşünmeyi yönetir
GitHub Yardımcı Pilotu	OAuth + Yardımcı Pilot jetonu	Github	Çift jeton, VSCode başlığını taklit eden
Kiro (AWS)	AWS SSO OIDC veya Sosyal	Kiro	İkili EventStream ayrıştırma
İmleç IDE'si	Sağlama toplamı kimlik doğrulaması	İmleç	Protobuf kodlaması, SHA-256 sağlama toplamları
Qwen	OAuth	Varsayılan	Standart yetkilendirme
Kod	OAuth (Temel + Taşıyıcı)	Varsayılan	Çift kimlik doğrulama başlığı
OpenRouter	API anahtarı	Varsayılan	Standart Taşıyıcı yetkilendirmesi
GLM, Kimi, MiniMax	API anahtarı	Varsayılan	Claude uyumlu, 'x-api-key' kullanın
openai uyumlu-*	API anahtarı	Varsayılan	Dinamik: OpenAI uyumlu herhangi bir uç nokta
`antropik-uyumlu-*'	API anahtarı	Varsayılan	Dinamik: Claude uyumlu herhangi bir uç nokta	---

8. Data Flow Summary

Streaming Request

flowchart LR
    A["Client"] --> B["detectFormat()"]
    B --> C["translateRequest()\nsource → OpenAI → target"]
    C --> D["Executor\nbuildUrl + buildHeaders"]
    D --> E["fetch(providerURL)"]
    E --> F["createSSEStream()\nTRANSLATE mode"]
    F --> G["parseSSELine()"]
    G --> H["translateResponse()\ntarget → OpenAI → source"]
    H --> I["extractUsage()\n+ addBuffer"]
    I --> J["formatSSE()"]
    J --> K["Client receives\ntranslated SSE"]
    K --> L["logUsage()\nsaveRequestUsage()"]

Non-Streaming Request

flowchart LR
    A["Client"] --> B["detectFormat()"]
    B --> C["translateRequest()\nsource → OpenAI → target"]
    C --> D["Executor.execute()"]
    D --> E["translateResponse()\ntarget → OpenAI → source"]
    E --> F["Return JSON\nresponse"]

Bypass Flow (Claude CLI)

flowchart LR
    A["Claude CLI request"] --> B{"Match bypass\npattern?"}
    B -->|"Title/Warmup/Count"| C["Generate fake\nOpenAI response"]
    B -->|"No match"| D["Normal flow"]
    C --> E["Translate to\nsource format"]
    E --> F["Return without\ncalling provider"]