---
title: "OpenAI uyumlu API'ye geçiş: kontrol listesi | BroadRouter"
description: "base_url'i değiştirmek işin kolay kısmı. Bozulanlar model kimlikleri, akıl yürütme token'ları, akışta kullanım, hatalar, hız sınırları ve anahtarlar. Kodlu liste."
url: https://broadrouter.com/tr/blog/openai-compatible-api-migration-checklist/
lang: tr
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

İngilizceden yapay zekâ desteğiyle çevrilmiştir. [İngilizce aslını okuyun](https://broadrouter.com/blog/openai-compatible-api-migration-checklist/) (güncelleme: 2026-11-16).

# OpenAI uyumlu API'ye geçiş: adım adım kontrol listesi

BroadNet Inference ekibi · 5 dk okuma · Yayımlandı 2026-11-14 · Güncellendi 2026-11-16

OpenAI uyumlu bir API'ye geçmek için üç ayarı (base\_url, api\_key ve model) değiştirin, ardından farklı olanları kontrol edin: model kimlikleri, akıl yürütme token'larının max\_tokens'a nasıl sayıldığı, akışta kullanımın nasıl raporlandığı, hangi hataların yeniden deneneceği, hız sınırları ve anahtar güvenliği. BroadNet Inference için temel URL https://inference.broadnet.ai/v1 adresidir.

## Öne çıkanlar

-   Üç ayar değişir: `base_url`, `api_key` ve `model`.
-   Geçişten önce uygulamanızın kullandığı her uç noktanın ve alanın envanterini çıkarın, sonra her birini test edin.
-   Akıl yürütme modelleri düşünmeyi `max_tokens` sınırına sayar; küçük sınırlar boş yanıt döndürür.
-   Akışlarda kullanımı `stream_options` ile isteyin; yoksa maliyet takibiniz kör kalır.
-   Üretim trafiğini taşımadan önce hata kodlarını yeniden dene ya da düzelt diye eşleyin.
-   Geçişi tamamlamadan önce eski ve yeni sağlayıcıyı bir gün boyunca gerçek trafikte yan yana çalıştırın.

**Bu sayfada**

1.  0\. Uygulamanız bugün neleri kullanıyor?
2.  1\. Hangi üç ayar değişir?
3.  2\. Yeni model kimlikleri neler?
4.  3\. Geçişten sonra yanıtlar neden boş geliyor?
5.  4\. Akış hâlâ kullanım bilgisini raporluyor mu?
6.  5\. Hangi hataları yeniden denemelisiniz?
7.  6\. Yeni hız sınırları neler?
8.  7\. İstemleriniz hâlâ sığacak mı?
9.  8\. Anahtarlar ve veri saklama ne olacak?
10.  9\. Geçişi güvenle nasıl tamamlarsınız?
11.  Yaygın geçiş hataları neler?
12.  BroadNet Inference nereye oturuyor?

LLM sağlayıcılarının çoğu artık [OpenAI API biçimini](https://broadrouter.com/tr/glossary/openai-compatible-api/) konuşuyor. Bu, geçişi tek satırlık bir değişiklik gibi gösterir; ilk yanıtı almak için gerçekten de öyledir. Üretim trafiği çalıştırmak içinse bu listeyi baştan sona uygulayın. Her madde, geçişlerin gerçekte bozulduğu bir yoldan geliyor.

## 0\. Uygulamanız bugün neleri kullanıyor?

Herhangi bir şeyi değiştirmeden önce uygulamanızın nelere bağlı olduğunu yazın. Kodda SDK’ya yapılan her çağrıyı arayın ve listeleyin. OpenAI’ın Whisper API’sini çağırıyorsanız, OpenAI’ın `whisper-1` modelini 26 Şubat 2027’de kapanacak olarak listelediğini not edin; ses tarafı için [Whisper API alternatifleri](https://broadrouter.com/tr/blog/whisper-api-alternative/) yazısına bakın.

| Özellik | Nereye bakmalı | Geçişten sonra test |
| --- | --- | --- |
| Chat completions | Her `chat.completions.create` | Aynı istemler, yanıtları karşılaştırın |
| Akış (streaming) | `stream=True` | Parçalar geliyor, `[DONE]` ile bitiyor, kullanım bilgisi var |
| Araç çağırma | `tools=` | Araç çağrıları ayrıştırılıyor ve çalışıyor |
| Yapılandırılmış çıktı | `response_format=` | JSON şemanıza göre doğrulanıyor |
| Görseller | Mesajlardaki görsel parçaları | Model kabul ediyor |
| Ses transkripsiyonu | `audio.transcriptions` | Metin ve dil doğru |
| Embedding, dosyalar, toplu işler | Diğer uç noktalar | Sağlayıcının bunları sunup sunmadığını kontrol edin |

Son satır önemli. “OpenAI uyumlu” genellikle önce chat completions’ı kapsar. BroadNet Inference’ın kataloğu sohbet modellerini `/v1/chat/completions`, konuşmadan metne modellerini `/v1/audio/transcriptions` üzerinde listeler; başka uç noktalar kullanıyorsanız onları mevcut sağlayıcınızda tutun veya bir alternatif bulun.

## 1\. Hangi üç ayar değişir?

```python
from openai import OpenAI
import os

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
```

[Temel URL (base URL)](https://broadrouter.com/tr/glossary/base-url/) ayarının adı kütüphaneye göre değişir: Python SDK’da ve LangChain’in ChatOpenAI’ında `base_url`, Node.js SDK’da `baseURL`. [README](https://github.com/openai/openai-python) dosyasına göre Python SDK ayrıca `OPENAI_BASE_URL` ortam değişkenini okur. Ortamınızda eski bir değer kalıp kalmadığını kontrol edin; yoksa istekler hiçbir hata vermeden eski sağlayıcıya gidebilir.

[API anahtarlarını](https://broadrouter.com/tr/glossary/api-key/) kodda değil, ortam değişkenlerinde veya bir gizli bilgi yöneticisinde (secret manager) tutun. Her SDK için kurulum: [Python](https://broadrouter.com/tr/guides/openai-python-sdk/), [Node.js](https://broadrouter.com/tr/guides/openai-node-sdk/), [LangChain](https://broadrouter.com/tr/guides/langchain-openai-base-url/). İlk isteği elle oluşturup test etmek için [API istek oluşturucuyu](https://broadrouter.com/tools/api-request-builder/) kullanın. Temel URL, anahtar ve model değişikliklerini mevcut kodunuza uygulamak için kodu [OpenAI’dan BroadNet’e geçiş yardımcısına](https://broadrouter.com/tools/openai-to-broadnet-migration/) yapıştırın; araç kontrol edilecekleri de listeler.

## 2\. Yeni model kimlikleri neler?

Her sağlayıcı modelleri kendi yöntemiyle adlandırır. BroadNet Inference’ta:

| Model | Kimlik |
| --- | --- |
| DeepSeek V4.1 Flash | `broadnet/deepseek-v4.1-flash` |
| GLM 5.3 | `broadnet/glm-5.3` |
| Qwen3.8 27B | `broadnet/qwen3.8-27b` |
| Gemma 4 VL 26B | `broadnet/gemma-4-26b-a4b` |

Model kimliğini koda değil yapılandırmaya koyun; böylece ileride değiştirmek bir yeniden yazım değil, bir dağıtım olur. Her modelin sınırları ve fiyatları kendi sayfasında: [DeepSeek V4.1 Flash](https://broadrouter.com/tr/models/deepseek-v4.1-flash/), [GLM 5.3](https://broadrouter.com/tr/models/glm-5.3/), [Qwen3.8 27B](https://broadrouter.com/tr/models/qwen3.8-27b/) ve [Gemma 4 VL 26B](https://broadrouter.com/tr/models/gemma-4-vl-26b/).

## 3\. Geçişten sonra yanıtlar neden boş geliyor?

En yaygın sürpriz budur. DeepSeek V4.1 Flash, GLM 5.3 ve Qwen3.8 27B yanıt vermeden önce akıl yürütür ve **[akıl yürütme token’ları](https://broadrouter.com/tr/glossary/reasoning-tokens/) [`max_tokens`](https://broadrouter.com/tr/glossary/max-tokens/) sınırına sayılır**. Akıl yürütmeyen bir modelde işe yarayan 256’lık bir sınır tamamen düşünmeye harcanabilir; yanıt boş döner. 1.000 veya daha fazla token bırakın ya da basit işler için `reasoning_effort` değerini `low` yapın. [Ayrıntılı açıklama](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/).

## 4\. Akış hâlâ kullanım bilgisini raporluyor mu?

[Akışlar](https://broadrouter.com/tr/glossary/streaming/) Server-Sent Events kullanır ve `data: [DONE]` ile biter. Token kullanımı yalnızca isterseniz son parçada gelir:

```python
stream = client.chat.completions.create(
    model="broadnet/deepseek-v4.1-flash", messages=messages,
    stream=True, stream_options={"include_usage": True},
)
```

Bu olmadan maliyet panonuz sıfır gösterir. Bir akış `[DONE]` gelmeden biterse onu eksik sayın. [Akış rehberi](https://broadrouter.com/tr/guides/streaming-chat-completions/).

## 5\. Hangi hataları yeniden denemelisiniz?

| Durum | Anlamı | Yapılacak |
| --- | --- | --- |
| 401 | Hatalı veya iptal edilmiş anahtar ya da tükenmiş kullandıkça öde kullanım hakkı | Düzeltin, yeniden denemeyin |
| 402 | Bakiye veya bütçe | Bakiye yükleyin, yeniden denemeyin |
| 403 | Model, rota veya IP politikası nedeniyle reddedildi | Uyuşmazlığı düzeltin |
| 413 | İstek çok büyük | Küçültün, yeniden denemeyin |
| 429 | Hız, eşzamanlılık veya harcama sınırı | Geri çekilin ve yeniden deneyin |
| 5xx | Sunucu tarafı | Sınırlı geri çekilmeyle yeniden deneyin |

Resmi Python SDK bazı hataları zaten yeniden dener: README’sine göre bağlantı hataları, 408, 409, 429 ve 5xx yanıtları varsayılan olarak kısa bir üstel geri çekilmeyle iki kez yeniden denenir. Bu davranış bir varsayılan değil bir karar olsun diye `max_retries` değerini açıkça ayarlayın. Destek ekibinin bir sorunu izleyebilmesi için her yanıttaki istek kimliğini kaydedin. [Tüm kodlar](https://broadrouter.com/tr/guides/errors-and-retries/).

## 6\. Yeni hız sınırları neler?

Trafik gelmeden yeni sınırları bilin. BroadNet’te kullandıkça öde anahtarı dakikada 30 isteğe ve aynı anda 4 uçuştaki isteğe izin verir. Sınırsız planlar oturum başına aynı anda tek istek çalıştırır. İşçi havuzunuzu buna göre boyutlandırın, yoksa ilk gün 429 görürsünüz; boyutlandırmayı [hız sınırı hesaplayıcısı](https://broadrouter.com/tools/llm-rate-limit-calculator/) yapar. [Paralel ajanlar için boyutlandırma](https://broadrouter.com/tr/blog/run-parallel-coding-agents-flat-rate/).

## 7\. İstemleriniz hâlâ sığacak mı?

Bağlam pencerelerini kontrol edin: DeepSeek V4.1 Flash ve GLM 5.3’te 1.048.576 token, Qwen3.8 27B’de 262.144, Gemma 4 VL 26B’de 32.768. Eski modelinize sığan bir istem daha küçük bir pencereye sığmayabilir; [bağlam penceresi hesaplayıcısıyla](https://broadrouter.com/tools/context-window-calculator/) kontrol edin. [Önbellekli girdi fiyatından](https://broadrouter.com/tr/blog/cached-input-tokens-explained/) yararlanmak için istemin değişmeyen kısmını başa koyun.

## 8\. Anahtarlar ve veri saklama ne olacak?

Üretim anahtarlarını bir [IP izin listesiyle](https://broadrouter.com/tr/guides/api-keys-ip-allow-lists/) sunucularınızın IP’lerine kilitleyin. Yeni sağlayıcıya neyi sakladığını sorun; [ZDR kontrol listesine](https://broadrouter.com/tr/blog/zero-data-retention-llm-api-checklist/) bakın.

## 9\. Geçişi güvenle nasıl tamamlarsınız?

1.  Bir günlük gerçek isteklerin bir kopyasını iki sağlayıcıya da gönderin.
2.  Bir örneklem üzerinde yanıtları; ayrıca gecikmeyi, hataları ve istek başına maliyeti karşılaştırın.
3.  Trafiğin %10’unu taşıyın, bir gün izleyin, sonra kalanını taşıyın.
4.  Eski sağlayıcıyı bir hafta boyunca yedek olarak yapılandırılmış halde tutun.

Çok sayıda servis çalıştırıyorsanız [LiteLLM](https://broadrouter.com/tr/guides/litellm-proxy-custom-provider/) gibi bir proxy, sağlayıcıyı her uygulamada ayrı ayrı değil tek bir yerde değiştirmenizi sağlar.

## Yaygın geçiş hataları neler?

-   **Temel URL’de eksik `/v1`.** İstekler 404 döndürür. Eksiksiz URL’yi kullanın.
-   **Yapılandırmada eski model adları.** Yeni sağlayıcı bunları tanımaz.
-   **İsteklerde kalan sağlayıcıya özgü alanlar.** Yalnızca eski sağlayıcının anladığı alanlar reddedilebilir veya yok sayılabilir. Bunları genel istemcilerden kaldırın.
-   **Yalnızca tek bir istemi test etmek.** 0. adımdaki envanteri özellik özellik uygulayın.
-   **Geçişi cuma günü yapmak.** Gerçek trafiğin tam bir gününü izlemeye zaman bırakın.

## BroadNet Inference nereye oturuyor?

BroadNet Inference, OpenAI SDK’ları üzerinden chat completions ve ses transkripsiyonu kullanan uygulamalar için doğrudan yerine geçebilen bir hedeftir: üç ayarı değiştirin ve yukarıdaki listeyi uygulayın. Kataloğunda yalnızca sohbet ve konuşmadan metne modelleri var; embedding veya dosya depolama gibi başka uç noktalara bağlıysanız onları başka bir sağlayıcıda tutun. Yeni hesaplar $5 kredisiyle başlar. Sohbet modellerinden yalnızca Gemma 4 VL 26B bu krediyle çalışır (kredi iki Transcribe modelini de kapsar); bu yüzden DeepSeek, GLM veya Qwen üzerinde bir gölge test için bakiye yüklemeniz gerekir.

Bu konu için ücretsiz araçlar (İngilizce)

-   [OpenAI to BroadNet migration helper](https://broadrouter.com/tools/openai-to-broadnet-migration/) Paste OpenAI SDK code; get base URL, key and model edits, a diff and the checks that remain.
-   [max\_tokens calculator for reasoning models](https://broadrouter.com/tools/reasoning-token-budget/) Answer length + reasoning budget + margin = a max\_tokens that does not cut the answer off.
-   [JSON schema generator for LLM structured output](https://broadrouter.com/tools/json-schema-generator/) Sample JSON to strict schema, Pydantic, Zod and a ready request.
-   [LLM JSON output validator](https://broadrouter.com/tools/llm-json-output-validator/) Parse errors by line and column, safe repairs, cut-off detection and JSON Schema checks for model output.

[Ücretsiz araçlar (İngilizce)](https://broadrouter.com/tools/)

## Bu yazıdaki terimler

[Akış (streaming)](https://broadrouter.com/tr/glossary/streaming/)

Akış (streaming), bir dil modeli yanıtını sonda tek parça halinde değil, hâlâ üretilirken küçük parçalar halinde döndürme yöntemidir. OpenAI uyumlu API'ler, istekte stream değeri true olduğunda server-sent events (SSE) üzerinden akış yapar.

[Araç çağırma (tool calling)](https://broadrouter.com/tr/glossary/tool-calling/)

Araç çağırma (tool calling), fonksiyon çağırma (function calling) olarak da bilinir; modelin, geliştiricinin tanımladığı bir fonksiyonu çalıştırmak için JSON argümanlı yapılandırılmış bir istek döndürdüğü bir LLM API özelliğidir. Fonksiyonu uygulama çalıştırır ve sonucu geri gönderir; model hiçbir zaman kodu kendisi çalıştırmaz.

[Base URL (temel URL)](https://broadrouter.com/tr/glossary/base-url/)

Base URL (temel URL), https://api.example.com/v1 gibi, bir istemcinin /chat/completions gibi her uç nokta yolunun önüne eklediği sabit kök adrestir. OpenAI uyumlu SDK'larda base URL, API anahtarı ve model kimliğiyle birlikte değiştirildiğinde aynı kod farklı bir sağlayıcıya yönelir.

[Token](https://broadrouter.com/tr/glossary/token/)

Token, bir dil modelinin okuduğu ve yazdığı metin birimidir: modelin tokenizer'ının ürettiği bir kelime, kelime parçası, noktalama işareti veya bayt dizisi. LLM API'leri kullanımı token cinsinden sayar, sınırlar ve genellikle faturalandırır.

[Kullandıkça öde (pay-as-you-go)](https://broadrouter.com/tr/glossary/pay-as-you-go/)

Kullandıkça öde, abonelik veya asgari taahhüt olmadan yalnızca kullandığınız kadar ödediğiniz, token, istek veya ses dakikası gibi birimler üzerinden ölçülen bir fiyatlandırma modelidir. LLM API'lerinin çoğu bu şekilde, ön ödemeli bir bakiyeden veya dönemsel faturayla ücretlendirir.

[Chat Completions API](https://broadrouter.com/tr/glossary/chat-completions-api/)

Chat Completions API, OpenAI'nin bir model adı ile rollerle etiketlenmiş mesaj listesini alıp modelin sonraki mesajını döndüren HTTP uç noktasıdır: POST /v1/chat/completions. İstek ve yanıt yapısı, OpenAI uyumlu sağlayıcıların ve SDK'ların yeniden kullandığı ortak format hâline geldi.

[Eşzamanlılık (concurrency)](https://broadrouter.com/tr/glossary/concurrency/)

Eşzamanlılık (concurrency), bir istemcinin aynı anda işlemde olan istek sayısıdır. LLM API'leri bunu genellikle dakikadaki istek sayısından ayrı olarak anahtar veya plan başına sınırlar, çünkü açık her istek yanıtı bitene kadar GPU kapasitesi tutar.

[Embedding (gömme vektörü)](https://broadrouter.com/tr/glossary/embeddings/)

Embedding'ler (gömme vektörleri), bir modelin bir metin parçasını, görseli veya başka bir girdiyi temsil etmek için ürettiği kayan noktalı sayı listeleridir (vektörler). Anlamca benzer girdiler birbirine yakın vektörler alır; bu yüzden vektörler arasındaki mesafe arama sonuçlarını sıralamak, belgeleri kümelemek veya ilgili öğeleri bulmak için kullanılabilir.

## Sık sorulan sorular

### Farklı bir SDK'ya ihtiyacım var mı?

Hayır. Python ve Node.js için resmi OpenAI SDK'ları özel bir temel URL kabul eder. LangChain'in ChatOpenAI'ı gibi bunların üzerine kurulu çatılar da kabul eder.

### OpenAI SDK'da base URL nasıl değiştirilir?

İstemciye Python'da base\_url, Node.js'te baseURL parametresini verin ya da OPENAI\_BASE\_URL ortam değişkenini ayarlayın. BroadNet Inference için değer https://inference.broadnet.ai/v1 adresidir; anahtar api\_key alanına girer.

### Geçişten sonra neden boş yanıt alıyorum?

DeepSeek V4.1 Flash, GLM 5.3 ve Qwen3.8 27B gibi akıl yürütme modelleri yanıt vermeden önce düşünür ve bu düşünme max\_tokens sınırına sayılır. max\_tokens değerini 1.000 veya daha yukarı çıkarın ya da reasoning\_effort değerini low yapın.

### Geçişten sonra neden 404 veya model bulunamadı hatası alıyorum?

Genellikle model kimliği hâlâ eski sağlayıcının adıdır ya da temel URL'de /v1 yolu eksiktir. Yeni sağlayıcının tam model kimliğini ve eksiksiz temel URL'yi kullanın.

### Hangi hataları yeniden denemeliyim?

429 ve 5xx hatalarını sınırlı üstel geri çekilmeyle yeniden deneyin. 401, 402 ve 413 hatalarını yeniden denemeden önce düzeltin. Bu sitedeki hatalar rehberi her kodu listeler.

### OpenAI uyumlu, birebir aynı demek mi?

Hayır. İstek ve yanıt yapıları eşleşir; ancak model kimlikleri, desteklenen parametreler, sınırlar, kullanım alanları ve hata ayrıntıları farklı olabilir. Uygulamanızın kullandığı her özelliği test edin.

## Okumaya devam edin

-   [OpenAI uyumlu API base URL listesi: 14 sağlayıcı kontrol edildi](https://broadrouter.com/tr/blog/openai-compatible-api-base-urls/)
-   [Yapay zeka ajanları için OpenRouter mı, sabit fiyatlı plan mı?](https://broadrouter.com/tr/blog/openrouter-alternative-flat-rate/)
-   [1M token'lık bağlam penceresi ne zaman değer (ve ne zaman değmez)?](https://broadrouter.com/tr/blog/million-token-context-window-guide/)
-   [Sıfır veri saklama (ZDR) LLM API: 10 soruluk kontrol listesi](https://broadrouter.com/tr/blog/zero-data-retention-llm-api-checklist/)
-   [BroadNet'in GPU donanımı ve sunum yaklaşımı, BroadNet'in anlatımıyla](https://broadrouter.com/tr/blog/broadnet-gpu-fleet-and-serving/)
-   [LLM API yanıtlarını önbelleğe alıp maliyeti düşürün: Python örneği](https://broadrouter.com/tr/blog/cache-llm-responses-cut-cost/)
-   [Rehber: OpenAI Python SDK'yı BroadNet Inference ile kullanın](https://broadrouter.com/tr/guides/openai-python-sdk/)
-   [Rehber: OpenAI Node.js SDK'yı BroadNet Inference ile kullanın](https://broadrouter.com/tr/guides/openai-node-sdk/)
-   [Rehber: LangChain'i BroadNet Inference ile kullanın](https://broadrouter.com/tr/guides/langchain-openai-base-url/)
-   [Rehber: BroadNet Inference hata kodları ve ne zaman yeniden denenmeli](https://broadrouter.com/tr/guides/errors-and-retries/)
-   [Rehber: Chat completions akışı ve kopan bağlantıları ele alma](https://broadrouter.com/tr/guides/streaming-chat-completions/)
-   [Rehber: Akıl yürüten model neden boş yanıt döndürür?](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/)
-   [Rehber: LiteLLM'i BroadNet Inference'a yönlendirin (SDK ve proxy)](https://broadrouter.com/tr/guides/litellm-proxy-custom-provider/)

Gerçek iş yükünüzle deneyin. Yeni hesaplar şunlar için US$5 kredi ile başlar: Gemma ve transkripsiyon. Bakiye yüklemesi gerekenler: DeepSeek, GLM ve Qwen3.8.

[Başlayın](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-blog-openai-compatible-api-migration-checklist&utm_content=page-cta) ·

**Kaynaklar**

-   [BroadNet Inference API referansı (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-blog-openai-compatible-api-migration-checklist&utm_content=sources)
-   [OpenAI Python SDK README (base\_url, OPENAI\_BASE\_URL, yeniden denemeler; 2026-11-14 tarihinde kontrol edildi)](https://github.com/openai/openai-python)
