OpenAI uyumlu bir API, OpenAI API’siyle aynı istek yapısını kabul eder; bu yüzden resmi OpenAI SDK’ları base_url ve API anahtarını değiştirdiğinizde çalışır. İşin zor kısmı, her sağlayıcının uç noktasını biraz farklı bir yere koymasıdır. Aşağıdaki tablo 14 sağlayıcıyı listeliyor; her biri 15 Kasım 2026’da sağlayıcının kendi belgelerinden okundu.
OpenAI uyumlu her sağlayıcının base URL adresi nedir?
| Sağlayıcı | Base URL | OpenAI uyumluluk belgelerinde listelenenler | Belgelerde belirtilen farklar |
|---|---|---|---|
| OpenAI | https://api.openai.com/v1 |
Her şey; referans olan odur | Hiçbir şey ayarlanmadığında SDK varsayılanı |
| Anthropic | https://api.anthropic.com/v1/ |
Chat completions | “Primarily intended to test and compare model capabilities” (BroadRouter çevirisi: “esas olarak model yeteneklerini test etmek ve karşılaştırmak için tasarlanmıştır”); strict yok sayılır; ses ve dosya girdileri 400 döndürür |
| Google Gemini | https://generativelanguage.googleapis.com/v1beta/openai/ |
Chat completions, embeddings, görsel üretimi, modeller, batch | OpenAI kütüphanesi desteği “still in beta” (BroadRouter çevirisi: “hâlâ beta aşamasında”); Responses API listelenmemiş |
| DeepSeek | https://api.deepseek.com |
Chat completions | Sürüm yolu yok; Anthropic biçimi için ayrı URL: /anthropic |
| Groq | https://api.groq.com/openai/v1 |
Chat completions, Responses API; ses transkripsiyonu üzerine notlar | logprobs, logit_bias, top_logprobs, messages[].name 400 döndürür; n 1 olmalı; srt veya vtt transkript yok |
| Together AI | https://api.together.ai/v1 |
Chat, completions, görseller, konuşma sentezi, transkripsiyon, modeller, Responses | Yalnızca ABD’de çıkarım için https://us-api.together.ai/v1; embeddings yalnızca ayrılmış uç noktalarda |
| Fireworks AI | https://api.fireworks.ai/inference/v1 |
Chat completions | accounts/fireworks/models/… biçiminde model kimlikleri; aksi söylenmedikçe hata vermek yerine max_tokens değerini bağlama sığacak şekilde düşürür |
| DeepInfra | https://api.deepinfra.com/v1/openai |
Chat completions; Responses istemcileri aynı temeli kullanır | Embeddings, görseller ve konuşma sentezi ayrı bir sayfada belgelenmiş |
| Mistral AI | https://api.mistral.ai/v1 |
POST /v1/chat/completions |
API referansı kendisini OpenAI uyumlu olarak tanımlamıyor; güvenmeden önce test edin |
| OpenRouter | https://openrouter.ai/api/v1 |
Chat completions | Sıralamaları için isteğe bağlı HTTP-Referer ve X-OpenRouter-Title başlıkları |
| xAI | https://api.x.ai/v1 |
Responses API | Rehberinde “The Responses API is the preferred way of interacting with our models” yazıyor (BroadRouter çevirisi: “Modellerimizle etkileşimin tercih edilen yolu Responses API’dir”) |
| Z.ai (GLM) | https://api.z.ai/api/paas/v4/ |
Chat completions | v1 değil, v4 yolu |
| Alibaba Model Studio | https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 (Singapur) |
Chat completions | Çalışma alanı kimliği host adının içinde; anahtar yalnızca oluşturulduğu bölgede çalışır, aksi halde 401 |
| BroadNet Inference | https://inference.broadnet.ai/v1 |
Chat completions, audio transcriptions | Model kimlikleri broadnet/ ile başlar; aşağıya bakın |
Alibaba, us-east-1 üzerinde bir ABD (Virginia) uç noktası da listeliyor. Aynı sayfadaki Pekin satırı Singapur host adını gösterirken sayfadaki başka bir metin cn-beijing adını veriyor; Çin uç noktasını konsoldan doğrulayın. Tablo bir anlık görüntüdür. Uç noktalar değişir: biz kontrol ederken hem Anthropic’in hem Google’ın belgeleri yeni adreslere yönlendirildi.
Bu sağlayıcıların fiyatları için sağlayıcıya göre LLM API fiyatları sayfalarına bakın.
Base URL kodda nasıl ayarlanır?
Python’da base_url değerini istemciye verin:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://inference.broadnet.ai/v1",
api_key=os.environ["BROADNET_API_KEY"],
)
r = client.chat.completions.create(
model="broadnet/gemma-4-26b-a4b",
messages=[{"role": "user", "content": "Say hello in one line."}],
)
print(r.choices[0].message.content)
Node’da seçeneğin adı baseURL:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://inference.broadnet.ai/v1",
apiKey: process.env.BROADNET_API_KEY,
});
Ya da resmi SDK’ları kullanan tüm araçlar için bir kez ayarlayın. Node SDK’nın kaynak kodu baseURL için önce process.env['OPENAI_BASE_URL'] değerini, o yoksa https://api.openai.com/v1 adresini kullanır; Python README’si de aynı değişkeni belgeler:
export OPENAI_BASE_URL="https://inference.broadnet.ai/v1"
export OPENAI_API_KEY="your-key"
Adım adım anlatımlar: OpenAI Python SDK, OpenAI Node SDK. Base URL nedir ve araçlar neden bunu sorar, sözlükte bulabilirsiniz.
Yeni bir base URL curl ile nasıl test edilir?
Uygulama kodunu değiştirmeden önce tek bir küçük istek gönderin:
curl https://inference.broadnet.ai/v1/chat/completions \
-H "Authorization: Bearer $BROADNET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "broadnet/gemma-4-26b-a4b", "messages": [{"role": "user", "content": "ping"}], "max_tokens": 20}'
Base URL’yi, anahtarı ve modeli test ettiğiniz sağlayıcınınkilerle değiştirin. choices dizisi içeren bir 200 yanıtı, yolun, anahtarın ve model kimliğinin doğru olduğunu gösterir. 404 genellikle yolun yanlış olduğu anlamına gelir; 401 anahtarın veya bölgenin yanlış olduğunu gösterir; 400 ise çoğu zaman sağlayıcının reddettiği parametrenin adını verir. cURL hızlı başlangıç rehberinde daha fazla örnek var; API istek oluşturucu ise curl, Python ve Node sürümlerini sizin için yazar.
base_url değiştirirken sık yapılan hatalar nelerdir?
- Uç noktanın tamamını yapıştırmak. SDK sona
/chat/completionsekler. Zaten bununla biten bir base URL/chat/completions/chat/completionsüretir ve 404 alırsınız. - Alışkanlıkla
/v1eklemek veya silmek. DeepSeek’in belgelenen temel adresinde/v1yoktur, Z.ai’ninki/v4/ile, Gemini’ninki/v1beta/openai/ile biter. Sağlayıcının verdiği dizeyi birebir kopyalayın. - OpenAI model adlarını korumak.
gpt-…adları başka yerde çalışmaz. Her sağlayıcının kendi biçimi vardır: DeepInfra’dadeepseek-ai/DeepSeek-V4-Flash-0731, Fireworks’teaccounts/fireworks/models/…, BroadNet’tebroadnet/deepseek-v4.1-flash. - Sağlayıcının reddettiği veya yok saydığı parametreleri göndermek. Groq
logprobsiçin 400 döndürür; Anthropic’in katmanıseed,logit_biasvereasoning_effortparametrelerini sessizce yok sayar. Sessizce yok sayılan bir parametre hatadan daha kötüdür, çünkü size hiçbir şey söylenmez. - Yanıt alanlarının aynı olduğunu varsaymak. Anthropic’in katmanı boş
prompt_tokens_detailsdöndürür, yani önbellekli token raporu eksiktir. Fireworks akıştaki kullanım bilgisini son parçaya koyar; SDK tipleri bunu tanımlamıyor olabilir. - Her uç noktanın var olduğunu varsaymak. “OpenAI uyumlu” genellikle chat completions demektir. Tablonun gösterdiği gibi embeddings, ses, görsel üretimi ve Responses API ayrı konulardır.
- Bölgeleri karıştırmak. Alibaba anahtarları bir bölgeye bağlıdır, Together ise yalnızca ABD için ayrı bir host sunar. Geçerli bir anahtar yanlış host’ta yine başarısız olur.
Geçişten önceki tam liste OpenAI uyumlu geçiş kontrol listesinde.
BroadNet Inference hangi uç noktaları destekliyor?
BroadNet’in API referansı, https://inference.broadnet.ai/v1 üzerinde iki model uç noktası ve katalog meta verileri için GET /v1/models belgeler:
| Uç nokta | Modeller |
|---|---|
POST /v1/chat/completions |
DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B, BroadNet Gemma 4 VL 26B |
POST /v1/audio/transcriptions |
BroadNet Transcribe Arabic, BroadNet Transcribe (14 dil) |
Bunun pratikteki anlamı:
- Embeddings, görsel üretimi veya Responses API belgelenmemiştir. Bunlardan birini gerektiren bir araç, o kısım için ikinci bir sağlayıcıya ihtiyaç duyar.
- Araç çağırma ve yapılandırılmış çıktı GLM 5.3 ve Qwen3.8 27B için belgelenmiştir.
- Görseller
data:URL’leri olarakimage_urliçerik parçalarının içinde gönderilir; DeepSeek V4.1 Flash, Qwen3.8 27B ve Gemma 4 VL 26B’de. - Akıl yürütme modelleri (DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B) akıl yürütmeyi
max_tokenssınırına dahil eder. Belgelerin önerdiği gibi 1.000 veya daha fazla token pay bırakın ya dareasoning_effortdeğerinilowyapın; bkz. akıl yürütme modelleri neden boş yanıt döndürür. - Model listesi yanıt verdi: 15 Kasım 2026’da
GET /v1/modelsçağırdığımızda bir liste döndü, ama bu uç nokta belgelenen uç noktalar listesinde yok; üzerine bir şey inşa etmeyin. - Sınırlar: Kullandıkça öde anahtarlarında dakikada 30 istek ve aynı anda 4 istek.
1M token başına fiyatlar: DeepSeek V4.1 Flash $0.175 girdi ve $0.52 çıktı, Gemma 4 VL 26B $0.10 ve $0.22. DeepSeek V4.1 Flash ayrıca aynı anda tek istekle, oturum başına aylık $60 tutarında sabit fiyatlı plan olarak da satılır.
Birden fazla sağlayıcıyı tek bir base URL üzerinden yönlendirmeli misiniz?
Uygulamanız bu sağlayıcılardan birkaçını çağırıyorsa LiteLLM gibi bir proxy, kodunuza tek bir base URL verir ve model adlarını her bir üst sağlayıcıya eşler. Eşlemeyi siz seçersiniz; yedekleri (fallback) kendiniz yapılandırmadıkça hiçbir şey sağlayıcıyı sizin yerinize değiştirmez. LLM API yedekleme (failover) yazısı bunu bir istemcide veya LiteLLM’de nasıl yapacağınızı gösterir. LiteLLM proxy rehberi bir BroadNet kaydını gösterir. Terimin arka planı için OpenAI uyumlu API maddesine bakın.
BroadNet Inference nerede devreye giriyor
Kodunuz zaten chat completions ile konuşuyorsa ve açık modeller, Arapça ve çok dilli konuşmadan metne ya da tek anahtarda sabit fiyatlı bir DeepSeek oturumu istiyorsanız BroadNet iyi bir seçenektir. Aynı sağlayıcıdan embeddings, Responses API veya görsel üretimine ihtiyacınız varsa uygun değildir; Together AI ve Gemini, OpenAI yüzeyinin daha fazlasını belgeler. Bu URL’ler ve uç nokta listeleri değiştiği için yayına almadan önce tablomuzu her sağlayıcının belgeleriyle karşılaştırın.
