BroadRouter
Başlayın

OpenAI uyumlu API base URL listesi: 14 sağlayıcı kontrol edildi

BroadNet Inference ekibi · 6 dk okuma · Yayımlandı

OpenAI uyumlu bir API'de OpenAI SDK'sını korur, yalnızca iki şeyi değiştirirsiniz: base_url ve API anahtarı. Temel URL sağlayıcıya göre değişir: Groq için https://api.groq.com/openai/v1, OpenRouter için https://openrouter.ai/api/v1, BroadNet Inference için https://inference.broadnet.ai/v1. Yollar, model kimlikleri ve desteklenen parametreler yine farklıdır; geçmeden önce tek bir istekle test edin.

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/completions ekler. Zaten bununla biten bir base URL /chat/completions/chat/completions üretir ve 404 alırsınız.
  • Alışkanlıkla /v1 eklemek veya silmek. DeepSeek’in belgelenen temel adresinde /v1 yoktur, 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’da deepseek-ai/DeepSeek-V4-Flash-0731, Fireworks’te accounts/fireworks/models/…, BroadNet’te broadnet/deepseek-v4.1-flash.
  • Sağlayıcının reddettiği veya yok saydığı parametreleri göndermek. Groq logprobs için 400 döndürür; Anthropic’in katmanı seed, logit_bias ve reasoning_effort parametrelerini 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_details dö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 olarak image_url iç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_tokens sınırına dahil eder. Belgelerin önerdiği gibi 1.000 veya daha fazla token pay bırakın ya da reasoning_effort değerini low yapı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.

Sık sorulan sorular

OpenAI API'nin base URL adresi nedir?

https://api.openai.com/v1. Resmi Node SDK, ne baseURL ne de OPENAI_BASE_URL ortam değişkeni ayarlandığında bu adresi kullanır.

base_url /v1 ile mi, /chat/completions ile mi bitmeli?

Sağlayıcının belgelerinde nerede bitiyorsa orada, genellikle /v1. SDK /chat/completions kısmını kendisi ekler; zaten /chat/completions ile biten bir temel URL 404 hatası verir.

Base URL'yi ortam değişkeniyle ayarlayabilir miyim?

Evet. İki resmi OpenAI SDK'sı da OPENAI_BASE_URL değişkenini okur, bunlar üzerine kurulu birçok araç da öyle. Yanına OPENAI_API_KEY tanımlayın ve her aracın belgelerine bakın, çünkü bazıları kendi değişken adlarını kullanır.

Claude API OpenAI uyumlu mu?

Kısmen. Anthropic, OpenAI SDK'sı için https://api.anthropic.com/v1/ adresini sunar, ancak bu katmanın uzun vadeli bir üretim yolu değil, esas olarak modelleri test etmek ve karşılaştırmak için olduğunu söyler. Araçlardaki strict ayarını yok sayar, ses ve dosya girdilerini reddeder.

BroadNet Inference hangi uç noktaları destekliyor?

Belgeleri POST /v1/chat/completions ve POST /v1/audio/transcriptions uç noktalarını listeler. Embeddings, görsel üretimi veya Responses API listede yoktur.

İsteğim OpenAI'da çalışıyor ama başka bir sağlayıcıda neden hata veriyor?

Genellikle model kimliği yanlış biçimdedir ya da sağlayıcının reddettiği bir parametre gönderilmiştir. Örneğin Groq; logprobs, logit_bias, top_logprobs ve messages[].name için 400 döndürür. İsteğe bağlı parametreleri çıkarın ve sağlayıcının tam model kimliğiyle yeniden deneyin.

Markdown olarak okuChatGPT asistanına sorClaude asistanına sorPerplexity asistanına sor