OpenAI Uyumlu AI Gateway: Tek Satırda Geçiş

OpenAI Uyumlu AI Gateway Nedir?

OpenAI uyumlu API gateway, birden fazla AI modelini — Claude, GPT, Gemini ve GLM-5.1, Qwen, Kimi, MiniMax gibi güçlü Çinli modelleri — OpenAI'nin resmi API'sine göndereceğiniz aynı istek formatıyla çağırmanızı sağlayan birleşik bir endpoint'tir. Birden fazla SDK, API anahtarı ve faturalama hesabıyla uğraşmak yerine, isteklerinizi tek bir base URL'e gönderirsiniz ve gateway routing, fallback ve faturalama işlemlerini arka planda halleder.

Geleneksel LLM entegrasyonları sizi tek bir sağlayıcıya kilitler. OpenAI SDK kullanıyorsanız, yalnızca OpenAI modellerini çağırabilirsiniz. Anthropic'in Claude'una ihtiyacınız olursa, kodunuzu farklı bir SDK ve format için yeniden yazarsınız. Bir AI gateway bu kilidi kırar: tek API anahtarı, tek istek formatı, 16+ premium modele erişim.

Neden Doğrudan Sağlayıcı API'leri Yerine AI Gateway Kullanmalı?

Doğrudan sağlayıcı erişiminin, token başına fiyatın ötesinde gizli maliyetleri vardır. Rate limitleri yönetir, kesinti sürelerini halleder, harcamalarınızı üç farklı dashboard'da takip eder ve bir model kotası istek ortasında tükendiğinde özel fallback mantığı yazarsınız. Bir gateway bunların hepsini çözer:

• Akıllı routing ile maliyet tasarrufu. GPT ve Claude gibi premium modeller pahalıdır. Bir gateway, isteklerinizin ~%30'unu seçtiğiniz modele, ~%70'ini eşdeğer yüksek kaliteli Çinli modellere yönlendirerek, çıktı kalitesini korurken maliyeti %90'a varan oranda düşürebilir.
• Otomatik fallback. Bir model kotaya ulaştığında veya çökdüğünde, gateway anında alternatife geçer — manuel müdahale yok, başarısız istek yok.
• Her şey için tek API anahtarı. Ayrı OpenAI, Anthropic ve Gemini hesaplarına ihtiyacınız yok. Tek anahtar, tek fatura, tüm modellere erişim.
• Token bazlı faturalama, kullandıkça öde. Aylık abonelik yok. Bakiye yüklersiniz ve kullanılan token başına ödersiniz. Bir projeye ara verirseniz, harcama durur — boşa harcanan retainer yok.
• Detaylı analytics. Her isteği, her token sayısını ve her maliyeti tek bir dashboard'da görürsünüz. Model performansını karşılaştırın ve optimizasyon fırsatlarını belirleyin.

Gerçek Dünya Senaryosu: OpenAI Kilitlenmesinden Çok-Modelli Özgürlüğe

gpt-4 ile çalışan bir kodlama asistanı geliştiriyorsunuz. Aylık faturanız 800$'a ulaşıyor, ancak isteklerin %70'i basit görevler — docstring oluşturma, küçük fonksiyonları refactor etme — frontier-tier akıl yürütme gerektirmiyor. Bir AI gateway ile aynı kodu saklarsınız ancak yzapi.store'a yönlendirirsiniz. Gateway, yüksek değerli istekleri otomatik olarak gpt-4'e, rutin olanları glm-5.1 veya qwen-plus'a gönderir, faturanızı yaklaşık 80-100$/ay'a düşürür. Uygulamanız daha hızlı çalışır (Çinli modeller genellikle daha düşük gecikmeye sahiptir) ve fallback mantığına hiç dokunmazsınız — gateway halletti.

yzapi.store'a Nasıl Geçilir: Bir Satır Kod

OpenAI uyumlu bir gateway'in güzelliği, migrasyon için sıfır refactoring gerektirmesidir. Kodunuz zaten OpenAI Python veya JavaScript SDK kullanıyorsa, yalnızca base URL ve API anahtarını değiştirmeniz gerekir. İşte nasıl:

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    base_url="https://yzapi.store/v1",
    api_key="yz_sk_..." # Bunu /dashboard/keys'ten alın
)

response = client.chat.completions.create(
    model="claude-sonnet", # veya gpt-4, glm-5.1, qwen-plus, vb.
    messages=[{"role": "user", "content": "Kuantum bilişimi açıkla"}]
)

Bu kadar. Mevcut mantığınız — streaming, tool calling, çok turlu konuşmalar — olduğu gibi çalışır. Gateway, OpenAI formatındaki isteğinizi arka planda hedef modelin yerel formatına çevirir.

Node.js (OpenAI SDK)

import OpenAI from 'openai';

const client = new OpenAI({
    baseURL: 'https://yzapi.store/v1',
    apiKey: 'yz_sk_...'
});

const completion = await client.chat.completions.create({
    model: 'claude-opus',
    messages: [{role: 'user', content: 'Kullanıcı verilerini çeken bir TypeScript fonksiyonu yaz'}]
});

Claude Code, Cursor veya Cline mi Kullanıyorsunuz?

Anthropic API'sini destekleyen AI kodlama araçları, yzapi.store'un Anthropic uyumlu endpoint'ine bağlanabilir. Ortam değişkenlerinizi ayarlayın:

export ANTHROPIC_BASE_URL=https://yzapi.store
export ANTHROPIC_AUTH_TOKEN=yz_sk_...
export ANTHROPIC_MODEL=claude-sonnet

Not: Anthropic uyumlu araçlar için /v1 olmadan https://yzapi.store kullanın. OpenAI uyumlu araçlar için base URL'ye /v1 ekleyin. Aracın dokümantasyonuna bakarak hangi formatı beklediğini kontrol edin.

CLI Araçları için Tek Komut Kurulum

Komut satırı AI araçları (codex, aider, vb.) kullanıyorsanız, yzapi.store ortam değişkenlerini otomatik olarak yapılandıran bir yükleyici script sunar:

curl -fsSL https://yzapi.store/install.sh | sh

Windows'ta:

irm https://yzapi.store/install.ps1 | iex

Hangi Modeller Mevcut?

yzapi.store, tek bir API anahtarıyla 16+ aktif modele erişim sağlar:

• Claude: claude-opus, claude-sonnet, claude-haiku (Anthropic'in akıl yürütme ağırlıklı modelleri)
• GPT: gpt-4, codex (OpenAI ve kod özelleştirilmiş modeller)
• Çinli modeller: glm-5, glm-5.1 (Zhipu AI), qwen-3.6-plus, qwen-3.7-max, qwen-3.5-plus (Alibaba), kimi-k2.5, kimi-k2.6 (Moonshot), minimax-m2.5, minimax-m3 (MiniMax), deepseek-v4-pro, deepseek-flash (DeepSeek)
• Gemini: Google'ın multimodal modelleri

Canlı fiyatlandırmayla birlikte tam listeyi model karşılaştırma sayfasında görün. /v1/models endpoint'ini programatik olarak da sorgulayabilirsiniz.

Akıllı Routing: Combo Stratejisi

claude-opus veya gpt-4 gibi bir premium model çağırdığınızda, yzapi.store kaliteden ödün vermeden maliyetleri düşürmek için akıllı routing (combo stratejisi) uygulayabilir. İsteklerinizin yaklaşık %30'u seçtiğiniz premium modele giderken, yaklaşık %70'i eşdeğer yüksek kaliteli Çinli modellere yönlendirilir (örn. claude-sonnet → glm-5.1). Bu yaklaşım, frontier-tier çıktı kalitesini korurken önemli maliyet azalımı sağlar — doğrudan sağlayıcı fiyatlandırmasına göre %90'a varan tasarruf.

Routing şeffaftır: hangi modelin her isteğe hizmet ettiğini dashboard analytics'te tam olarak görürsünüz. Deterministik routing'e (her zaman aynı model) ihtiyacınız varsa, API key ayarlarınızda combo routing'i devre dışı bırakabilirsiniz.

Otomatik Fallback Zinciri

Bir model hesabı kotasına veya rate limit'e ulaşırsa, yzapi.store otomatik olarak benzer bir modele düşer. Fallback zinciri özel bir DeepSeek hesabıyla sona erer ve isteklerinizin asla başarısız olmamasını sağlar. Bu kesintisiz süreklilik, sıfır kesinti süresi ve manuel müdahale olmadan — üst düzey sağlayıcıların sorun yaşadığı durumlarda bile uygulamanız çalışmaya devam eder.

Tool Calling, Streaming ve Çok Turlu Konuşmalar

Modern LLM uygulamaları, function calling, server-sent event streaming ve stateful çok turlu agentlar gibi gelişmiş özelliklere dayanır. yzapi.store, bunların hepsini OpenAI uyumlu arayüz üzerinden destekler:

• Tool/function calling: Hem OpenAI tool_calls formatı hem Anthropic tool_use formatı desteklenir. Gateway, isteğinizi hedef modelin yerel tool-calling şemasına çevirir.
• Streaming (SSE): İsteğinizde stream=true ayarlayın. Oluşturuldukça delta parçalarını alacaksınız, OpenAI'nin streaming yanıtıyla özdeş.
• Agentic döngüler: Tool call'lu çok turlu konuşmalar kutunun dışında çalışır. Gateway, mesaj geçmişini ve tool sonuçlarını turlar boyunca korur.

Örnek: Streaming + Tool Calling

response = client.chat.completions.create(
    model="claude-opus",
    messages=[{"role": "user", "content": "Tokyo'da hava nasıl?"}],
    tools=[{
        "type": "function",
        "function": {
            "name": "get_weather",
            "parameters": {"type": "object", "properties": {"city": {"type": "string"}}}
        }
    }],
    stream=True
)

for chunk in response:
    print(chunk.choices[0].delta.content, end="")

Gateway, hedef model Claude ise OpenAI tool şemasından Anthropic'in tool_use formatına çeviriyi halleder, böylece bir kez yazarsınız ve her yerde çalışır.

Faturalama: Token Bazlı Kullandıkça Öde

yzapi.store, token bazlı faturalama ile kullandıkça öde fiyatlandırması kullanır. Bakiyenizi yükleyin (5$'dan başlar) ve maliyet token başına gerçek zamanlı olarak düşülür. Zorunlu aylık abonelik yok. Öngörülebilir bütçeleme tercih eden kullanıcılar için opsiyonel günlük-kredi planları mevcuttur, ancak temel model basittir: yalnızca kullandığınız için ödeme yapın. Bir projeye ara verirseniz, harcama hemen durur.

Tier'ları karşılaştırmak ve doğrudan sağlayıcı fiyatlandırmasına göre tasarrufları hesaplamak için fiyatlandırma bölümüne bakın.

60 Saniyede Başlayın

OpenAI uyumlu bir AI gateway denemek için hazır mısınız? İşte en hızlı yol:

1. yzapi.store'da ücretsiz kaydolun (kredi kartı gerekmez — başlamak için başlangıç kredisi alırsınız).
2. API Keys'e gidin ve yeni bir anahtar oluşturun. yz_sk_... gibi görünecektir.
3. Kodunuzun base_url'ini https://yzapi.store/v1 olarak güncelleyin ve yeni API anahtarınızı yapıştırın.
4. Mevcut OpenAI SDK kodunuzu çalıştırın. Hemen çalışır.

Migrasyon kılavuzu yok. SDK refactor yok. Bir satır değişir ve otomatik fallback ve maliyet optimizasyonuyla 16+ model üzerinden routing yaparsınız.

Sorularınız mı var? Token başına fiyatlandırmayı görmek için model karşılaştırmasına bakın veya akıllı routing'in harcamanızı nasıl düşürdüğünü anlamak için dashboard analytics'i keşfedin. Detaylı yetenek dökümü için modele özel sayfaları da göz atabilirsiniz.