OpenAI uyumlu API nedir? Tek satırla sağlayıcı değiştirme

Tek satırla geçiş

OpenAI SDK'ları varsayılan olarak istekleri OpenAI'a gönderir, ancak temel URL ayarını da destekler. Bu URL'yi başka bir sağlayıcıya yönlendirin, o sağlayıcının anahtarını ve model adlarını kullanın; kodun geri kalanı aynı kalır.

from openai import OpenAI
client = OpenAI(
    base_url="https://api.zurelay.com/v1",  # the only line that changes
    api_key="YOUR_ZURELAY_KEY",
)
reply = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[{"role": "user", "content": "Hello"}],
)
print(reply.choices[0].message.content)

Aynı yöntem TypeScript'te baseURL ile ve "OpenAI temel URL'si" veya "özel uç nokta" isteyen araçlarda da çalışır: OpenCode, Continue, Cline, Open WebUI ve daha pek çoğu. Her birinin ayarlarını entegrasyon kılavuzlarında bulabilirsiniz. Birçok araç OPENAI_BASE_URL ve OPENAI_API_KEY ortam değişkenlerini de okur; böylece hiç kod değiştirmeden geçiş yapabilirsiniz.

Başlıca sağlayıcıların temel URL'leri

Temel URL genellikle /v1 ile biter ve SDK buna /chat/completions ekler. Bazı sağlayıcılar farklı yollar kullanır; bu yüzden bunları aynen kopyalayın:

Her sağlayıcının URL'sini, bir model kimliğini ve her uç noktanın ne sunduğunu OpenAI uyumlu temel URL'ler listesinde bulabilirsiniz; bilgiler 26 Ekim 2026 tarihinde sağlayıcıların kendi belgelerinden alınmıştır.

Neler aynı kalır

• Mesajlar, sistem istemleri ve akış halinde yanıtlar.
• Araç çağırma ve JSON şemasıyla yapılandırılmış çıktı.
• Bunları okuyabilen modeller için mesajdaki görseller ve diğer dosyalar.
• Kullanım bilgileri bölümü; böylece token hesabı aynı şekilde çalışır.

Geçişten önce kontrol etmeniz gerekenler

• Model adları. Her sağlayıcının kendine özgü kimlikleri vardır; bunları GET /v1/models ile listeleyin.
• Hangi API'leri sunduğu. Birçok sağlayıcı Chat Completions sunar ancak OpenAI'ın Responses, Realtime, embeddings veya batch API'lerini sunmaz. Zurelay; Chat Completions, görsel, video ve konuşma API'lerinin yanı sıra Claude için Anthropic'in Messages API'sini sunar.
• Ek parametreler. Akıl yürütme düzeyleri, önbellek kontrolleri ve örnekleme sınırları modele göre değişir. İyi bir sağlayıcı, her modelin hangi parametreleri kabul ettiğini belgeler.
• Gerçekten söylenen model mi? Ucuz sağlayıcılar bazen daha yeni bir model adı altında eski veya daha ucuz bir model sunar. Beş hızlı kontrolü ucuz yapay zekâ API'leri gerçekte ne satıyor yazısında bulabilirsiniz.

Geçişte sorun yaşarsanız

• 404 Not Found. Temel URL, uç noktayı (.../v1/chat/completions) içeriyor veya sağlayıcının kendi yolu eksik. Yalnızca temel URL'yi kullanın.
• 401 Unauthorized. Anahtar başka bir sağlayıcıya veya Alibaba'nın Model Studio hizmetinde başka bir bölgeye ait.
• Model not found. Aynı modelin kimliği sağlayıcıya göre değişir: Anthropic'te claude-opus-5-5, OpenRouter'da anthropic/claude-opus-5, Azure'da ise dağıtımınızın adı kullanılır.
• Bir parametrede 400 hatası. Bazı sağlayıcılar, OpenAI API'sinin kabul ettiği parametreleri reddeder veya yok sayar; örneğin Anthropic'in uyumluluk katmanında response_format. Parametreyi kaldırın veya onu destekleyen bir sağlayıcıya geçin.

Anthropic uyumlu API'ler

Claude Code ve Anthropic SDK'ları ise Anthropic'in Messages API'sini kullanır ve ANTHROPIC_BASE_URL değerini okur. DeepSeek, Moonshot, Z.ai, MiniMax ve Zurelay dahil birçok sağlayıcı bu API'yi de sunar; URL'leri hiçbir zaman /v1 ile bitmez. Bu sağlayıcıları listede bulabilirsiniz. Claude Code fiyatlandırması ise Claude Code maliyetlerini her plan ve API kullanımı için karşılaştırır.

Neden geçiş yapasınız

OpenAI uyumlu tek bir anahtarla birçok laboratuvarın modellerine erişebilirsiniz. Böylece Claude, GPT, Gemini ve DeepSeek'i kendi istemlerinizle karşılaştırmak için yalnızca model adını değiştirmeniz yeterlidir; daha ucuz bir modele geçmek de aynı derecede kolaydır. Modellere ve fiyatlara göz atın.