# FreeLLMAPI **Ayda 7,4 milyar token. 34 ücretsiz LLM sağlayıcısı. 635 ücretsiz model uç noktası. OpenAI uyumlu tek bir uç nokta.** Onlarca sağlayıcının ücretsiz kullanım kotalarını ve özel OpenAI uyumlu sohbet, gömme (embedding), görüntü ve ses uç noktalarını tek bir `/v1` API’sinde birleştirin. Anahtarlar şifreli saklanır. Yönlendirici, her istek için kullanılabilir en iyi modeli seçer; bir sağlayıcı hız sınırına ulaştığında sıradakine geçer ve ücretsiz kotaları aşmamak için kullanımı anahtar bazında izler. [![CI](https://github.com/tashfeenahmed/freellmapi/actions/workflows/ci.yml/badge.svg)](https://github.com/tashfeenahmed/freellmapi/actions/workflows/ci.yml) [![GitHub stars](https://img.shields.io/github/stars/tashfeenahmed/freellmapi?style=flat&logo=github&color=yellow)](https://github.com/tashfeenahmed/freellmapi/stargazers) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](#contributing) [![Docker image](https://img.shields.io/badge/ghcr.io-freellmapi-2496ED?logo=docker&logoColor=white)](https://github.com/tashfeenahmed/freellmapi/pkgs/container/freellmapi) [![Ask DeepWiki](https://img.shields.io/badge/DeepWiki-Ask-blue)](https://deepwiki.com/tashfeenahmed/freellmapi) **[freellmapi.co](https://freellmapi.co/?utm_source=github&utm_medium=readme&utm_campaign=repository&utm_content=readme_top)** · tüm kataloğa göz atın: 474 model ailesi, 635 ücretsiz uç nokta [English](README.md) · **Türkçe** · [简体中文](README.zh-cn.md) · [Русский](README.ru.md) · [O'zbekcha](README.uz.md)

macOS için indir Windows için indir Docker ile kendi ortamınızda çalıştırın Google Play’den edinin App Store’dan indirin

![FreeLLMAPI paneli — aylık token bütçesiyle Modeller sayfası](repo-assets/github-hero.png) Yönlendiriciniz model kataloğunu imzalı bir akıştan kendisi günceller: yeni ücretsiz modeller, kota değişiklikleri ve uyumluluk düzeltmeleri `git pull` gerekmeden gelir. Ücretsiz kurulumlar aylık anlık görüntüyü alır; modeller canlı akışa eklendikten 30 gün sonra bu kurulumlara ulaşır. Premium yönlendiriciler ise aynı gün alır. **[freellmapi.co ile canlı kataloğa geçin](https://freellmapi.co/?utm_source=github&utm_medium=readme&utm_campaign=premium&utm_content=readme_top#pricing)** (yılda 19 ABD doları; istediğiniz zaman iptal edin).
--- ## İçindekiler - [Neden geliştirildi?](#why-this-exists) - [Desteklenen sağlayıcılar](#supported-providers) - [Uyumlu CLI’lar ve kodlama ajanları](#compatible-clis--coding-agents) - [Diğer çözümlerle karşılaştırma](#how-it-compares) - [Özellikler](#features) - [Hızlı başlangıç](#quick-start) - [Masaüstü uygulaması](#desktop-app) - [OpenAI uyumlu istemcilerle kullanım](#works-with-openai-compatible-clients) - [Diller](#languages) - [Premium (canlı katalog)](#premium-live-catalog) - [API kullanımı](#using-the-api) - [Ekran görüntüleri](#screenshots) - [Nasıl çalışır?](#how-it-works) - [Sık sorulan sorular](#faq) - [Sınırlamalar](#limitations) - [Katkıda bulunma](#contributing) - [Sorumluluk reddi](#disclaimer) **Rehberler:** [Kurulum ve dağıtım](docs/en/install/01-install.md) · [API başvurusu](docs/en/api/01-rest-api.md) · [İstemciler ve kodlama ajanları](docs/en/clients/01-agent-clients.md) · [İstem sıkıştırma](docs/en/compression/01-compression-pipeline.md) · [Mimari ve iç işleyiş](docs/en/architecture/00-high-level-index.md) · [Belge dizini](docs/en/README.md) · [Katkı rehberi](CONTRIBUTING.md) ## Neden geliştirildi? Günümüzde önde gelen yapay zekâ laboratuvarları ayda birkaç milyon token, günde birkaç bin istek sunan ücretsiz planlar sağlıyor. Tek başlarına sınırlı olsalar da bir araya geldiklerinde, küçük ve hızlı modellerden oldukça yetenekli modellere kadar **474 model ailesi / 635 sağlayıcı uç noktası** üzerinden **ayda yaklaşık 7,4 milyar token** çıkarım kapasitesine ulaşıyorlar. Bunları elle birleştirmek zahmetli: otuz dört farklı SDK, otuz dört farklı hız sınırı ve bir isteğin başarısız olabileceği otuz dört ayrı yer. FreeLLMAPI hepsini OpenAI uyumlu tek bir uç noktada toplar. Herhangi bir OpenAI istemci kitaplığını yerel sunucunuza yönlendirin; istekler, anahtar eklediğiniz sağlayıcılar arasında istemciye yansımadan yönlendirilir. Ücretsiz planlar da her hafta değişiyor: sağlayıcılar yeni modeller çıkarıyor, eskilerini kaldırıyor ve kotaları haber vermeden değiştiriyor. FreeLLMAPI bunları sizin için takip eder. Yönlendirici, imzalı model kataloğunu [freellmapi.co](https://freellmapi.co) üzerinden kendisi alır; kurulumunuz `git pull` gerekmeden güncel kalır. Güncellemelerin ne kadar hızlı geldiği için [Premium (canlı katalog)](#premium-live-catalog) bölümüne bakın. ![Ücretsiz planlar bir arada — 34 sağlayıcıdan ayda yaklaşık 7,4 milyar token](repo-assets/i18n/tr/free-tier.png) ## Desteklenen sağlayıcılar
Google
Google
Groq
Groq
Cerebras
Cerebras
OpenCode Zen
OpenCode Zen
Mistral
Mistral
OpenRouter
OpenRouter
Cloudflare
Cloudflare
Cohere
Cohere
Z.ai (Zhipu)
Z.ai (Zhipu)
NVIDIA
NVIDIA
HuggingFace
HuggingFace
ModelScope
Qwen3 · DeepSeek V4 · GLM-5 (Aliyun cn hesabıyla bağlantı gerekir)
… ve 22 ücretsiz sağlayıcı daha
Ayrıca **özel** sağlayıcı desteği vardır: Anahtarlar (Keys) sayfasından sohbet, gömme, görüntü veya ses modellerini herhangi bir OpenAI uyumlu uç noktaya yönlendirin (llama.cpp, LM Studio, vLLM, yerel Ollama veya uzak bir ağ geçidi). Model bazında hız sınırları, bağlam pencereleri ve ücretsiz token bütçelerini içeren tam ve güncel liste **[freellmapi.co/models](https://freellmapi.co/models.html)** adresindedir. ## Uyumlu CLI’lar ve kodlama ajanları
Claude Code
Claude Code
Codex CLI
Codex CLI
Gemini CLI
Gemini CLI
Cursor
Cursor
Cline
Cline
Roo Code
Roo Code
OpenCode
OpenCode
Aider
Aider
… ayrıca Continue, Goose, Qwen Code, Kilo Code, Crush, Zed, JetBrains AI, DeepSeek Harness, MiMo Code, AtomCode, OpenClaw, Hermes Agent, Pi, Reasonix, ZCode ve OpenAI uyumlu, Anthropic, Gemini veya Ollama istemcileri
Çoğu ajan, canlı kataloğunuzu okuyup mevcut yapılandırmayı yedekleyen ve yeni ayarları onunla birleştiren tek bir komutla yapılandırılabilir: ```bash npx freellmapi setup-claude --url http://localhost:3001 --api-key ``` **[Desteklenen tüm ajanlar ve kurulum komutları →](docs/en/clients/02-supported-agents.md)** · [Araçlara özel ayarlar, MCP sunucusu ve URL tokenları →](docs/en/clients/01-agent-clients.md) ## Diğer çözümlerle karşılaştırma ![OpenRouter, LiteLLM ve Portkey ile özellik karşılaştırması](repo-assets/i18n/tr/comparison.png) Temmuz 2026 tarihli herkese açık belgelere dayanır; düzeltmelerinizi bekliyoruz. ## Özellikler ![Özelliklere genel bakış](repo-assets/i18n/tr/features.png) - **OpenAI tarzındaki tüm uç noktalar** — `/v1/chat/completions`, `/v1/responses` (Codex CLI için), `/v1/completions` (editörde satır içi otomatik tamamlama), `/v1/images/generations`, `/v1/videos/generations`, `/v1/audio/speech`, `/v1/audio/transcriptions`, `/v1/embeddings` ve `/v1/models`. Resmî SDK’larla veya OpenAI uyumlu istemcilerle akışlı ve akışsız çalışır. [API başvurusu →](docs/en/api/01-rest-api.md) - **Anthropic Messages API** — `/v1/messages`, aynı yönlendirici üzerinden Anthropic iletişim biçimini kullanır. Böylece **Claude Code** ve resmî Anthropic SDK’ları ücretsiz model havuzunuzla çalışır. [Ayrıntılar →](docs/en/api/01-rest-api.md#anthropic--claude-clients) - **Yerel Gemini ve Ollama arayüzleri** — Gemini CLI, `/v1beta` üzerinden `generateContent`, akış, token sayımı ve model listesini kullanabilir. İsteğe bağlı Ollama öykünmesi; Zed, JetBrains ve diğer yerel model istemcilerine NDJSON sohbet/üretim, etiket, üst veri ve gömme desteği sunar. - **Fusion (çok modelli sentez)** — sanal `fusion` modelini istediğinizde yönlendirici, isteminizi farklı ücretsiz modellere paralel gönderir. Ardından bir değerlendirme modeli taslaklardan tek bir yanıt oluşturur. [Ayrıntılar →](docs/en/api/01-rest-api.md#fusion-multi-model-synthesis) - **Görüntü, video ve konuşma üretimi** — `/v1/images/generations`, `/v1/videos/generations` ve `/v1/audio/speech`, ilgili medya modellerini sunan sağlayıcılara yönlendirilir. Görüntü ve konuşma için özel OpenAI uyumlu medya uç noktaları da kullanılabilir. Eşzamanlı ve kuyruklu sağlayıcıların video işleri ortak bir biçime dönüştürülür ve tamamlanmış MP4 döndürülür. - **Araç çağırma ve yapılandırılmış çıktılar** — OpenAI tarzı `tools` çağrıları sağlayıcılar arasında aktarılır; düz metin olarak gelen araç çağrıları gerçek `tool_calls` nesnelerine dönüştürülür. `response_format`, `seed`, `logprobs`, cezalar ve diğer örnekleme parametreleri sağlayıcı bazında iletilir. - **Akıllı yönlendirme, altı strateji** — modellerin canlı hız, yetenek ve güvenilirlik puanları zincirinizi sıralar. Otomatik yedek modele geçiş, 429/5xx hatalarında bekleme süreleri ve anahtar döndürmeyle sıradaki modeli dener. [Yönlendirme ayrıntıları →](docs/en/architecture/00-high-level-index.md#how-it-works) - **Birleştirilmiş modeller ve profiller** — birden çok sağlayıcıdaki aynı model tek girdide toplanır; hata durumunda geçiş kesin olarak bu grup içinde yapılır. Adlandırılmış yedek zincir profilleri (kodlama veya görsel işleme zinciri gibi) panelden ya da istek başına `auto:` ile seçilebilir. Özel zincirler zincir yöneticisinden yeniden adlandırılabilir. - **Anahtar bazında hız sınırı takibi** — her `(platform, model, key)` için RPM/RPD/TPM/TPD sayaçları, sağlayıcının bildirdiği üst sınırları öğrenerek yönlendirmenin kotaları aşmasını önler. - **Kendini güncelleyen model kataloğu** — yönlendirici, freellmapi.co üzerinden imzalı kataloğu günde iki kez eşitler. Yeni modeller, kota değişiklikleri ve sağlayıcı uyumluluk düzeltmeleri otomatik gelir. Ücretsiz kurulumlar, modellerin canlı akışa katıldıktan 30 gün sonra eklendiği aylık görüntüyü izler; Premium aynı gün alır. [Premium →](#premium-live-catalog) - **Modele bağlı oturumlar ve bağlam aktarımı** — konuşmalar 30 dakika boyunca aynı modelde kalır. Sohbet sırasında model değişirse isteğe bağlı kısa bir aktarım notu konuşmanın tutarlılığını korur. [Ayrıntılar →](docs/en/clients/01-agent-clients.md#context-handoff) - **İstem sıkıştırma (isteğe bağlı)** — hata durumunda isteği engellemeden sürdüren ortak işlem hattı; önbellek araması ve yönlendirmeden önce yinelenen istemleri kaldırabilir, araç çıktısını filtreleyebilir, tekrarlanan JSON’u sıkıştırabilir ve eski bağlamı kısaltabilir. [Ayrıntılar →](docs/en/compression/01-compression-pipeline.md) - **Şifreli anahtarlar, tek erişim tokenı** — sağlayıcı anahtarları SQLite içinde AES-256-GCM ile şifrelenir, her istek için bellekte çözülür. Uygulamalarınız yalnızca tek bir birleşik `freellmapi-…` bearer tokenı görür. - **Yönetim paneli ve analizler** — anahtar yönetimi, zincir sıralaması, deneme alanı ve 24 saat–90 günlük dönemlerde p50/p95/TTFT analizleri için React arayüzü. Oturum açma koruması, açık/koyu temalar ve [60 dil](#languages). - **ChatGPT uyumlu MCP sunucusu ve etkileşimli belgeler** — ChatGPT ve diğer MCP istemcileri FreeLLMAPI ile çıkarım yapabilir, kullanılabilir modelleri listeleyebilir, sağlayıcı sağlığı/kullanım/önbellek/yönlendirme üst verilerini inceleyebilir ve `/mcp` üzerinden stratejiyi yönetebilir. Bağımlılık gerektirmeyen OpenAPI görüntüleyicisi `/v1/docs` adresindedir. [ChatGPT ve kodlama ajanları →](docs/en/clients/01-agent-clients.md#mcp-server) - **İşletimi kolaylaştıran özellikler** — isteğe bağlı yanıt önbelleği, şifreli veritabanı yedekleri, düzenli anahtar sağlık kontrolleri, toplu anahtar içe/dışa aktarımı ve bildirimsel başlangıç yapılandırması. [Kurulum ve dağıtım →](docs/en/install/01-install.md) - **Node 20+ çalışan her yerde çalışır** — Windows, macOS, Linux sunucuları veya Raspberry Pi dâhil küçük ARM tek kart bilgisayarlar. PM2, systemd ya da tercih ettiğiniz süreç yöneticisiyle boşta yaklaşık 40 MB RSS bellek kullanımı. Kapsam bilinçli olarak dar tutulmuştur; [henüz desteklenmeyen özelliklere](docs/en/architecture/00-high-level-index.md#not-yet-supported) bakın. ## Hızlı başlangıç **Tek satırda kurulum** (Docker gerekir; `~/freellmapi` dizinini hazırlar, şifreleme anahtarı oluşturur, imajı indirir ve konteyneri başlatır): ```bash curl -fsSL https://freellmapi.co/install.sh | bash ``` Bash’e aktarmadan önce okumak ister misiniz? [Betik burada](https://freellmapi.co/install.sh). Yeniden çalıştırmak güvenlidir: `.env` dosyanız ve şifreleme anahtarınız korunur, konteyner `:latest` sürümüne güncellenir. http://localhost:3001 adresini açın, **Anahtarlar (Keys)** sayfasına sağlayıcı anahtarlarınızı ekleyin, **Yedek Model Zinciri (Fallback Chain)** sırasını istediğiniz gibi düzenleyin ve **Anahtarlar** sayfasının üst kısmından birleşik API anahtarınızı alın. OpenAI SDK’nızda bu birleşik anahtarı kullanın. Windows’ta en kolay yol, aşağıda açıklanan **[Releases bölümündeki `.exe` masaüstü yükleyicisidir](https://github.com/tashfeenahmed/freellmapi/releases/latest)**. Android için deneysel [Termux rehberine](docs/en/install/02-android-termux.md) bakın. Docker Compose, yerel geliştirme, bildirimsel başlangıç yapılandırması, üretim derlemeleri, yerel ağ erişimi ve yedeklemeler için **[kurulum rehberine](docs/en/install/01-install.md)** bakın. ## Masaüstü uygulaması [`desktop/`](./desktop) dizinindeki yerel menü çubuğu uygulaması, yönlendiriciyi ve yönetim panelini sistem tepsisinden çalıştırır; cam görünümlü açılır panelde canlı istek istatistiklerini gösterir. ![FreeLLMAPI masaüstü uygulaması](repo-assets/desktop.png) **[Releases bölümünden indirin](https://github.com/tashfeenahmed/freellmapi/releases/latest)** — her sürüme macOS `.dmg` ve Windows `.exe` yükleyicileri eklenir. Hesap veya parola oluşturmanız gerekmez; ihtiyacınız olan tek kimlik bilgisi tepsi panelindeki birleşik API anahtarıdır. Kaynaktan derleme adımları ve veri konumları: [masaüstü uygulaması rehberi](docs/en/install/01-install.md#desktop-app). macOS 12 Monterey ve sonrası için **arm64 (Apple Silicon)** veya **x64 (Intel)** sürümünü seçin. Her iki Mac derlemesinin ZIP paketi de sunulur. ## OpenAI uyumlu istemcilerle kullanım OpenAI uyumlu bir temel URL’ye bağlanabilen tüm istemciler çalışır: adresi `http://localhost:3001/v1` olarak ayarlayın ve paneldeki birleşik anahtarı kullanın. Tüm yapılandırma üreticileri `--dry-run` seçeneğini destekler. `npx freellmapi launch` (Claude Code) ve `launch-codex` (Codex), kimlik bilgilerini yapılandırma dosyalarına hiç yazmaz. Yönlendirici, ajanlarınızın oturum sırasında inceleyebileceği bir MCP sunucusu olarak da çalışır. **ChatGPT**, özel bir Secure MCP Tunnel üzerinden aynı yerel yönlendiriciye bağlanır. `ask_freellmapi` MCP aracı, ChatGPT’nin istediği görevi `/v1/chat/completions` üzerinden yönlendirir; yanıtı kullanılan model, yedek modele geçiş, önbellek, yürütme ve token üst verileriyle döndürür. Temel URL ve bearer kimlik doğrulaması tünel istemcisinin yapılandırmasında tutulur. Varsayılan model `MCP_INFERENCE_DEFAULT_MODEL` ile ayarlanır (belirtilmezse `auto`). Anahtarları Git’e veya MCP URL’sine eklemeyin. **[ChatGPT kurulumu →](docs/en/clients/01-agent-clients.md#chatgpt-private-secure-mcp-tunnel)** Sağlayıcı anahtarlarını panel oturum tokenıyla (`FREELLMAPI_DASHBOARD_TOKEN` veya `--token`) terminalden de yönetebilirsiniz: `npx freellmapi keys add|list|remove|test `. Buradaki `keys test`, kayıtlı anahtarları yeniden sınar. Bkz. [CLI rehberi](cli/README.md#provider-keys). FreeLLMAPI, yerelde çalışmayı esas alan ve tek kullanıcı için tasarlanmış bir uygulamadır. Sağlayıcı anahtarlarınız SQLite veritabanınızda şifreli saklanır; istekler makinenizden etkinleştirdiğiniz sağlayıcılara gider. ## Diller Yönetim paneli **60 dilde**, masaüstü tepsi menüsü ise 6 dilde sunulur. Arayüz ilk açılışta tarayıcı/sistem dilinizi otomatik algılar. Dili istediğiniz zaman **⋯ → Ayarlar (Settings)** üzerinden değiştirebilirsiniz; seçiminiz hatırlanır. Sağdan sola yazılan dillerde (العربية, עברית, فارسی, اردو) tüm yerleşim otomatik olarak tersine döner. Yalnızca etkin dilin sözlüğü yüklenir; diğerleri bant genişliğinizi kullanmaz. United States China Spain France Brazil Italy India Saudi Arabia Bangladesh Russia Pakistan Indonesia Germany Japan Kenya Türkiye Vietnam South Korea Iran Thailand Poland Ukraine Myanmar Romania Netherlands Malaysia Philippines Nigeria Ethiopia Uzbekistan Azerbaijan Sri Lanka Nepal Cambodia Greece Czechia Hungary Sweden Israel Denmark Finland Norway Slovakia Bulgaria Croatia Serbia Lithuania Taiwan Portugal Georgia Tam dil listesi [`client/src/i18n/locale-config.ts`](./client/src/i18n/locale-config.ts) dosyasındadır. İlk altı dil insan denetiminden geçmiştir. Daha sonra eklenen diller makine çevirisidir ve ana dili konuşanların düzeltmeleriyle iyileşir. Tek bir metni düzelten PR bile iyi bir ilk katkıdır. Çeviriler [`client/src/i18n/locales/`](./client/src/i18n/locales) dizininde düz JSON dosyaları olarak tutulur. Bir metni düzeltmek için ilgili dilin JSON dosyasındaki değeri düzenleyin. Yeni dil eklemek için `en.json` dosyasını kopyalayıp değerleri çevirin, dili `client/src/i18n/locale-config.ts` dosyasına kaydedin; tepsi metinleri için `desktop/src/i18n.ts` dosyasını da güncelleyin. `npm test`, her dilin anahtar ve yer tutucularının kaynakla eşleştiğini kontrol eder. PR’larınızı bekliyoruz. ## Premium (canlı katalog) Yönlendirici model kataloğunu kendisi güncel tutar: günde iki kez [freellmapi.co](https://freellmapi.co) üzerinden imzalı kataloğu alır, yeni modelleri, kota değişikliklerini ve sağlayıcılara özgü uyumluluk düzeltmelerini yerel veritabanınıza uygular. Etkinleştirme/devre dışı bırakma seçimleriniz ve özel sağlayıcılarınız değişmez. Her indirme uygulanmadan önce sabitlenmiş Ed25519 anahtarıyla doğrulanır. Katalog şu anda **34 sağlayıcı**, **474 model ailesi**, **635 ücretsiz sağlayıcı/model uç noktası** (584 sohbet, 41 gömme, 7 ses dökümü, 3 video) ve listelenen ücretsiz planlarda **ayda yaklaşık 7,4 milyar token** kapasitesini izler. Tam liste: **[freellmapi.co/models](https://freellmapi.co/models.html)**. Ücretsiz kurulumlar aynı imzalı kataloğun aylık anlık görüntüsünü alır. Bir model, canlı akışa eklendikten 30 gün sonra bu görüntüye katılır; bu nedenle ücretsiz sürüm şu anda yaklaşık 303 model geridedir. Hiçbir şeyin süresi dolmaz ve hiçbir özellik kısıtlanmaz; modeller yalnızca daha geç gelir. Premium, çalıştırdığınız tüm yönlendiricilerde imzalı kataloğu canlı tutar. Bir sağlayıcı güçlü bir ücretsiz model yayımladığında, kotasını sessizce daralttığında veya iletişim biçimini bozduğunda, canlı akışı kullanan yönlendiriciler düzeltmeyi yayımladığımız gün alır. **[freellmapi.co ile canlı kataloğa geçin →](https://freellmapi.co/?utm_source=github&utm_medium=readme&utm_campaign=premium&utm_content=readme_bottom#pricing)** - Yılda 19 ABD doları veya tek seferlik 49 ABD dolarıyla ömür boyu kullanım. Stripe üzerinden ödeme; istediğiniz zaman kendiniz iptal edebilirsiniz. - Tek bir `fla_` anahtarı çalıştırdığınız tüm yönlendiricileri kapsar: masaüstü, ev sunucusu, Raspberry Pi. - Panelde **Premium** bölümünden etkinleştirin; iptal ve faturalandırma işlemlerini [freellmapi.co/manage](https://freellmapi.co/manage) üzerinden kendiniz yönetin. - Yönlendirici her zaman MIT lisanslı ve tamamen ücretsiz kalır. Premium yalnızca canlı katalog akışını kapsar; kataloğun çalışır kalmasını sağlayan günlük model testlerini ve bakımını finanse eder. Katalog sunucusu istemlerinizi, model yanıtlarınızı veya sağlayıcı anahtarlarınızı hiçbir zaman görmez. Her iki durumda da yönlendirici tamamen sizin ortamınızda çalışır. ## API kullanımı ```python from openai import OpenAI client = OpenAI( base_url="http://localhost:3001/v1", api_key="freellmapi-your-unified-key", ) resp = client.chat.completions.create( model="auto", # let the router pick; or "auto:fast", "auto:smart", a profile, or a model id messages=[{"role": "user", "content": "Summarise the fall of Rome in one sentence."}], ) print(resp.choices[0].message.content) print("Routed via:", resp.headers.get("x-routed-via")) ``` Akışlı yanıtlar, `auto:*` yönlendirme stratejileri, araç çağırma, görsel girdiler, Gemini Google Search ile kaynaklandırma, gömmeler ve Anthropic Messages API’si için curl ve Python örnekleri **[API başvurusundadır](docs/en/api/01-rest-api.md)**. Her yanıt `X-Routed-Via: /` başlığı taşır; böylece isteği hangi sağlayıcının karşıladığını görebilirsiniz. ## Ekran görüntüleri ### Modeller Bir yönlendirme stratejisi seçin ve tüm sağlayıcıların aylık token bütçesini izleyin. Her model için canlı güvenilirlik, hız ve yetenek puanları gösterilir. Aşağıdaki sıralama, isteklerin o anda izlediği yönlendirme sırasıdır. ![Modeller sayfası](repo-assets/models.png) ### Anahtarlar Sağlayıcı kimlik bilgilerini yönetin ve uygulamalarınızın bağlanırken kullanacağı birleşik API anahtarını alın. Her anahtarın durum göstergesi ve son sağlık kontrolünün zamanı gösterilir. ![Anahtarlar sayfası](repo-assets/keys.png) ### Deneme alanı Yönlendirici üzerinden bir sohbet isteği gönderin; isteği hangi sağlayıcının karşıladığını, model kimliğini ve gecikmeyi doğrudan mesaj üzerinde görün. Düğme, sürükleyip bırakma veya yapıştırmayla dosya ekleyin. Görseller (PNG/JPEG/WebP/GIF) tarayıcıda küçültülüp görsel işleyebilen bir modele görüntü içeriği olarak gönderilir. Metin dosyaları (TXT/MD/CSV/JSON/LOG) ise isteme kod blokları içinde eklenir. ![Deneme alanı sayfası](repo-assets/playground.png) ### Analiz 24 saat / 7 gün / 30 gün / 90 günlük dönemlerde istek hacmi, başarı oranı, giriş ve çıkış tokenları, ortalama gecikme ve sağlayıcı bazındaki dağılımlar. ![Analiz sayfası](repo-assets/analytics.png) ## Nasıl çalışır? ![Tek istek, en iyi ücretsiz model — canlı puanlar, bekleme süreleri ve kota takibiyle yedek model zinciri](repo-assets/i18n/tr/router-flow.png) Tek istek, en iyi ücretsiz model: yönlendirici, geçerli bir anahtarı olan ve tüm hız sınırlarının altında kalan en yüksek öncelikli modeli seçer, anahtarın şifresini bellekte çözer ve sağlayıcıyı çağırır. 429/5xx hatasında bu anahtarı beklemeye alıp zincirdeki sıradaki modeli dener. Bileşenlerin açıklamaları, yönlendirmenin iç işleyişi ve işletim ayrıntıları **[mimari rehberindedir](docs/en/architecture/00-high-level-index.md)**. ## Sık sorulan sorular **Parola gerekiyor mu?** Masaüstü uygulamasında gerekmez. Panel gizli bir yerel hesapla otomatik oturum açar; oluşturmanız veya hatırlamanız gereken bir parola yoktur. Tepsi simgesi → **Paneli Aç (Open Dashboard)** yolunu kullanın ya da aynı bilgisayarda herhangi bir tarayıcıdan açın (örneğin http://127.0.0.1:31415); ikisi de otomatik giriş yapar. Yerel ağ üzerinden başka bir cihazla bağlanıldığında giriş formu gösterilir. Sunucu kurulumlarında (Docker, tek satırlık kurulum, `npm run dev`) e-posta ve parola kullanan bir hesap vardır. **Sunucu kurulumundaki parolamı unuttum.** Giriş sayfasında **Parolamı unuttum (Forgot password?)** seçeneğine tıklayın. Bağlantı göndermek için e-posta hizmeti bulunmadığından tek kullanımlık kod sunucu günlüğüne yazılır. Kodu `docker compose logs -f freellmapi` ile, sunucunun çalıştığı terminalden veya masaüstü günlük dosyasından okuyup sıfırlama formuna girin. Kod 15 dakika geçerlidir. **Günlükler nerede?** Docker kurulumunda konteyner günlüklerinde, kaynaktan çalıştırmada terminalde, masaüstünde ise `/logs/freeapi.log` dosyasındadır. Masaüstünde tepsi menüsündeki **Günlük Klasörünü Aç (Open Logs Folder)** seçeneğiyle ulaşabilirsiniz. **Nasıl kaldırırım?** Uygulamayı kaldırın (macOS’ta Çöp Sepeti, Windows’ta *Ayarlar → Uygulamalar*, Docker’da `docker compose down -v`), ardından veri dizinini silin: `%APPDATA%\FreeLLMAPI\`, `~/Library/Application Support/FreeLLMAPI/` veya `~/.config/FreeLLMAPI/`. Kaldırma işlemi bu klasörü kendiliğinden silmez. Kurulum yöntemine göre ayrıntılı yanıtlar: **[parolalar, günlükler ve kaldırma](docs/en/install/01-install.md#faq-passwords-logs-uninstall)**. ## Sınırlamalar Ücretsiz planları birleştirmenin bedelleri vardır: en ileri düzey modeller yoktur, gecikmeler değişkendir ve hizmet düzeyi garantisi (SLA) sunulmaz. En iyi modeller günlük kotalarına ulaştıkça uç noktanın yanıt kalitesi günün ilerleyen saatlerinde düşebilir; kotalar UTC gece yarısında sıfırlanır. Buna dayalı gerçek bir ürün geliştirmeden önce **[sınırlamalar listesini](docs/en/architecture/00-high-level-index.md#limitations)** okuyun. ## Katkıda bulunma Katkılarınızı bekliyoruz! Geliştirme süreci, PR beklentileri ve AI/LLM destekli katkı politikası için [CONTRIBUTING.md](CONTRIBUTING.md) dosyasına bakın. Kısaca: bu katkılar kabul edilir ve diğer PR’larla aynı kalite ölçütlerine tabidir. İlk katkı önerileri: - **Sağlayıcı ekleyin** — `server/src/providers/openai-compat.ts` dosyasını şablon olarak kopyalayın, `server/src/providers/index.ts` içine bağlayın, modellerini `server/src/db/index.ts` içinde tanımlayın ve `server/src/__tests__/providers/` dizinine test ekleyin. - **Uç nokta ekleyin** — diğer OpenAI uyumlu arayüzler (örneğin `/v1/realtime`). Sağlayıcı temel sınıfına yeni yöntemler eklenebilir; bağdaştırıcılar hangilerini desteklediklerini bildirir. - **Yönlendiriciyi iyileştirin** — maliyeti gözeten yönlendirme (ucuzluk, sağlık ve hız dengesi), gecikmeye göre daha iyi önceliklendirme, belirli bir bölgeye sabitleme. - **Paneli iyileştirin** — Analiz sayfasına grafikler, anahtar döndürme deneyimi, `.env` üzerinden toplu anahtar aktarımı. - **Belgelere katkıda bulunun** — daha fazla örnek, Go/Rust gibi diller için istemci kodları, Docker veya Fly için dağıtım tarifleri. `npm install && npm run dev`, sunucuyu :3001 ve paneli :5173 üzerinde HMR desteğiyle başlatır. Tekrarlanabilir kurulum için Bash’te `./scripts/dev-bootstrap.sh`, PowerShell’de `.\scripts\dev-bootstrap.ps1` kullanın; ikisi de mevcut `.env` dosyasını korur. PR’lar test içermeli, mevcut testlerin geçmesini sağlamalı (`npm test`) ve depodaki `.editorconfig` / tsconfig varsayılanlarına uymalıdır. Veritabanı geçiş iş akışı ve tüm katkı süreci [CONTRIBUTING.md](./CONTRIBUTING.md) dosyasındadır. ### Katkıda bulunanlar @moaaz12-web @AdityaxDeore @lukasulc @VinhPhamAI @deadc @zhangyu1324 @kentpan @stephenzwj @chongjiazhen @vjsai @long2ice @sadesguy @hodlmybeer69-bit @phoenixikkifullstack @jtbrennan-git @praveenkumarpranjal @nordbyte @mybropro @danscMax @jhash @JammyJames1234 @coffcoe @Sumit4codes @meliani @thedavidweng @bharvey42 @yuvrxj-afk @v0rtex1223 @nicyoong @Aldo-f @Tazrif-Raim @m1nuzz @suantea @OhOkThisIsFine @LoneRifle @ita333 @barbotkonv @Naster17 @StealthTensor @EmranAhmed @itsfuad @RobinHoodO @hmm183 @duemilionidieuro-bot @cagedbird043 @jasnoorgill @Joey9024 @AskingConical @ProAlit @hjhhoni @immanuelsavio @Slyker @wells1013 @evgkrsk @aaronjmars @Robs87 @dashitongzhi @QingJ01 @3215 @saifulaiub123 @PietFourie @mhmdkrmabd @DemeulemeesterxMaxime @HoodBlah @SeanPedersen @andersmmg @chirag127 @allababbot @johan-droid @redenfire @itzpingcat @kairwang01 @gongjurenzhangwei @jsonring @1029734570 @86TheCactus @AmiroKD @ecryptomillionaire-dev @4riful @fix2015 @iisyw @xsfhacg @noobix @nandukmelath @NirvanaCh7 @Mohamed3nan @Arman-Espiar @MetaMysteries8 @lujun880726 @qq97693453 @emv33 @ousamabenyounes @yfdyh000 @s-uryansh @arsalanyavari @RoboMWM @gaurang-py @ddy4633 @UrbsKali @hb-0 @xyblue135 @Icesenator @ZER0-auto @tashdroid @Patrickleondev @hiiamwaffledev @w0fv1 @oppih @n3dhir @ksp2000 @quabynahdavis @qinghuanandejiangshi @qatcod @CooperSheroy @shahidbeig-a11y @Kaban15 @efcunha @sukaimi @rome-xi @bsi-bcp @rodion-gudz @bjornmage @kenanlabs @xzyj50609 @Ahmedtahoon2 @Inference1 @yzhkali @levonk @tripstar6000 @alkank @Yi-111-a @The88788 @ac1982 @agammann @Claven07 @AymenJeddou @Thibaultjaigu @silvertakana @sidhunt @rubicon @JoAdo07 @igormutton @georgeatparallel @BNTiyan @ChaosCom @Alexis12119 @kevin9327 @ilya-bogin-keenable @harsHdokyc @ALANDVO @HyperionBurn @emirhantasli @jayhemnani9910 @ignamiranda @MoriDanWork @suvshox-oss @Swidan0 @w21180239 @kjgggggg @TheoCui-Saulcy @MatthewRobertDunn @nk-batman21 @PowerTokens @navzo @motasimfuad @thedevil11255 @kvianAR @TanmayShah29 @heydryft @leucds2018-hub @zhangkom @noahkhomer18 ## Sorumluluk reddi **Bu proje kişisel deneme ve öğrenme içindir; üretim ortamları için değildir.** Ücretsiz planlar geliştiricilerin prototip oluşturması için sunulur; kararlı ve destek garantisi olan bir çıkarım altyapısı değildir. FreeLLMAPI üzerine gerçek bir ürün geliştiriyorsanız yayımlamadan önce ücretli bir API’ye geçin. Sağlayıcılarla ilişkiniz, hesap oluştururken kabul ettiğiniz koşullara tabidir. Trafiği bu proje üzerinden yönlendirdiğinizde de bu koşullar geçerlidir ve bunlara uymak sizin sorumluluğunuzdadır. Sağlayıcıların hizmet koşullarında kişisel, tek kullanıcılı bir vekil sunucunun nasıl değerlendirildiğine ilişkin Mayıs 2026 tarihli inceleme için [hizmet koşulları değerlendirmesine](docs/en/architecture/00-high-level-index.md#terms-of-service-review) bakın. ## Lisans [MIT](./LICENSE)