---
title: "CrewAI özel OpenAI uyumlu base_url kurulumu | BroadRouter"
description: "CrewAI ajanlarını LLM(custom_openai=True, base_url=...) ile BroadNet Inference'a yönlendirin; ardından araçlar, uzun bağlam ve sabit fiyatlı plan için model seçin."
url: https://broadrouter.com/tr/guides/crewai-custom-openai-endpoint/
lang: tr
updated: 2026-11-16
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/guides/crewai-custom-openai-endpoint/) (güncelleme: 2026-11-16).

# CrewAI'ı özel OpenAI uç noktası olarak BroadNet Inference ile kullanın

Güncellendi 2026-11-16

Modeli crewai'ın LLM sınıfıyla oluşturun: model olarak broadnet/glm-5.3 gibi bir BroadNet kimliği, custom\_openai=True, base\_url olarak https://inference.broadnet.ai/v1 ve api\_key olarak BroadNet anahtarınızı verin. Sonra bu LLM'i her Agent'a atayın. CrewAI kendi yerel OpenAI istemcisini ve chat completions'ı kullanır; LiteLLM kurmanız gerekmez.

CrewAI, ajan ekipleri kurmaya yarayan bir Python çerçevesidir. Belgeleri bir **özel OpenAI uyumlu uç nokta** kalıbı gösterir: `custom_openai=True` ve `base_url` içeren bir `LLM`. BroadNet Inference `https://inference.broadnet.ai/v1` adresinde standart chat completions sunduğu için tam buraya oturur. BroadRouter, BroadNet’in kendi sitesidir; bu rehber CrewAI’ın 1.15.41 sürümündeki belgelerini ve kaynak kodunu izler.

## Kurulum

```bash
pip install crewai
export BROADNET_API_KEY='your-broadnet-key'
```

## Bağlanma

```python
import os
from crewai import LLM, Agent

llm = LLM(
    model="broadnet/glm-5.3",
    custom_openai=True,
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_tokens=4000,  # reasoning counts toward this limit
)

# Quick test: one call straight to the model
print(llm.call("Say hello in five words."))

analyst = Agent(
    role="Analyst",
    goal="Summarize incidents",
    backstory="You write short incident summaries.",
    llm=llm,
)
print(analyst.kickoff("Summarize: the API returned 503 for four minutes after a deploy."))
```

`llm.call` bir yanıt yazdırıyorsa anahtar, URL ve model kimliği doğrudur.

## CrewAI isteği nasıl yönlendirir

CrewAI’ın kaynak kodu bir sıra belirler: `custom_openai=True` ilk sırada gelir ve model adının ima ettiği her şeyi geçersiz kılarak yerel OpenAI sağlayıcısını zorunlu kılar. Ayrıca `base_url`, `api_base`, `OPENAI_BASE_URL` ya da `OPENAI_API_BASE` ile özel bir uç nokta ayarlanmadıysa hata verir. Model dizesi yazıldığı gibi gönderilir; böylece `broadnet/glm-5.3` BroadNet’e değişmeden ulaşır.

`custom_openai` olmadan `broadnet/glm-5.3` gibi bir ad, CrewAI’ın tanımadığı `broadnet` sağlayıcısı olarak okunur ve LiteLLM’e düşer. Belgelenmiş alternatif, bir `base_url` ile birlikte `model="openai/broadnet/glm-5.3"` yazmaktır: CrewAI `openai/` önekini kaldırır ve geri kalanını gönderir.

CrewAI’ın kodundan ve belgelerinden iki nokta daha:

-   **Token sınırı alanı.** `max_tokens` verdiğinizde yerel istemci chat completions isteğinde `max_tokens` gönderir; BroadNet’in API referansında tanımlanan alan da budur. `max_completion_tokens` verirseniz onun yerine o gönderilir.
-   **Chat completions’ta kalın.** CrewAI’ın belgeleri Responses API’ye geçmek için `api="responses"` gösterir. Bunu ayarlamayın; BroadNet bu API’yi listelemez.

## Hangi ajan için hangi model

| Ajan | Model | Neden |
| --- | --- | --- |
| Araç kullanan ajanlar | `broadnet/glm-5.3` | BroadNet araçları ve yapılandırılmış çıktıyı listeler; 1M bağlam |
| Görsel ya da Arapça girdi, araçlarla | `broadnet/qwen3.8-27b` | Araçlar ve görseller; 262K bağlam |
| Uzun okuma görevleri, sabit fiyatlı plan | `broadnet/deepseek-v4.1-flash` | Sınırsız planlar; araçlar BroadNet tarafından listelenmez |

Bir crew bunları karıştırabilir: her `Agent`’a kendi `LLM`’ini verin.

## Sorun giderme

-   **401.** Anahtar yanlış, süresi dolmuş ya da kullanım hakkı tükenmiş. `api_key` vermediyseniz CrewAI `OPENAI_API_KEY` değişkenini okumuştur; orada bir OpenAI anahtarı olabilir.
-   **“custom\_openai=True requires base\_url”.** `base_url` verin ya da `OPENAI_BASE_URL` ayarlayın.
-   **Model bulunamadı.** Kimliğin BroadNet’inkiyle birebir aynı olduğunu kontrol edin. Ücretli modeller bakiye yüklemesi gerektirir; $5 kredi yalnızca `broadnet/gemma-4-26b-a4b` modelini kapsar.
-   **`EmptyLLMResponseError`.** CrewAI boş bir yanıtı bir kez yeniden dener, sonra bu hatayı verir. `max_tokens` değerini artırın. [Yanıtlar neden boş geliyor](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/).
-   **Birden çok ajanla 429.** Kullandıkça öde anahtarı dakikada 30 isteğe ve işlemde aynı anda 4 isteğe izin verir; bir plan oturumu ise aynı anda tek istek çalıştırır. [Hatalar ve yeniden denemeler](https://broadrouter.com/tr/guides/errors-and-retries/) rehberine bakın.

## Bu rehberdeki terimler

[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.

[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.

[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.

[Bağlam penceresi (context window)](https://broadrouter.com/tr/glossary/context-window/)

Bağlam penceresi, bir dil modelinin tek bir istekte işleyebileceği en fazla token sayısıdır. Sistem istemini, konuşma geçmişini, araç tanımlarını, görselleri ve akıl yürütme token'ları dahil üretilen çıktıyı kapsar. Sığmayan her şey kesilmeli, özetlenmeli veya birden fazla isteğe bölünmelidir.

[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.

[Hız sınırı (rate limit)](https://broadrouter.com/tr/glossary/rate-limit/)

Hız sınırı (rate limit), bir API'nin bir istemcinin belirli bir zaman aralığındaki kullanımına koyduğu üst sınırdır; örneğin dakika başına istek veya dakika başına token. Sınırı aşan istekler, kullanım tekrar sınırın altına inene kadar genellikle HTTP 429 Too Many Requests ile reddedilir.

[OpenAI uyumlu API](https://broadrouter.com/tr/glossary/openai-compatible-api/)

OpenAI uyumlu API, POST /v1/chat/completions gibi OpenAI API'siyle aynı istek ve yanıt biçimlerini kabul eden bir HTTP API'sidir; böylece OpenAI SDK'ları ve araçları yalnızca base URL, API anahtarı ve model adı değiştirilerek onu kullanabilir.

[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.

## Sık sorulan sorular

### CrewAI'da custom\_openai=True ne işe yarar?

CrewAI'ın kaynak koduna göre model adı nasıl görünürse görünsün yerel OpenAI sağlayıcısını zorunlu kılar ve base\_url, api\_base, OPENAI\_BASE\_URL ya da OPENAI\_API\_BASE ister. Model dizesi yazıldığı gibi gönderilir; yani broadnet/glm-5.3 BroadNet'e değişmeden ulaşır.

### Bunun yerine model="openai/broadnet/glm-5.3" yazabilir miyim?

Evet. Özel bir base\_url ile CrewAI, openai/ önekini yerel OpenAI istemcisine yönlendirir ve öneki kaldırır; BroadNet broadnet/glm-5.3 alır. Yine de custom\_openai=True daha açık bir yazımdır.

### Crew'um neden EmptyLLMResponseError ile başarısız oluyor?

CrewAI, ne içerik ne de araç çağrısı içeren boş bir yanıtı bir kez yeniden dener; yeniden deneme de boş dönerse bu hatayı verir. BroadNet'in akıl yürüten modellerinde bu genellikle akıl yürütmenin çıktı bütçesini tükettiği anlamına gelir. max\_tokens değerini artırın.

### CrewAI ajanları hangi BroadNet modelini kullanmalı?

Araç kullanan ajanlar için GLM 5.3; BroadNet onun için araçları ve yapılandırılmış çıktıyı listeler. Qwen3.8 27B de araçları destekler ve görsel kabul eder.

## İlgili rehberler

-   [Pydantic AI ve BroadNet Inference (OpenAICompatibleProvider)](https://broadrouter.com/tr/guides/pydantic-ai-openai-compatible/)
-   [OpenAI Python SDK'yı BroadNet Inference ile kullanın](https://broadrouter.com/tr/guides/openai-python-sdk/)
-   [Akıl yürüten model neden boş yanıt döndürür?](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/)
-   [BroadNet Inference hata kodları ve ne zaman yeniden denenmeli](https://broadrouter.com/tr/guides/errors-and-retries/)
-   [BroadNet Inference ile çalışan tüm araçlar (İngilizce)](https://broadrouter.com/integrations/): SDK'lar, kodlama ajanları, sohbet arayüzleri ve otomasyon araçları, her biri için tam ayarlarıyla

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-guides-crewai-custom-openai-endpoint&utm_content=page-cta) ·

**Kaynaklar**

-   [CrewAI belgeleri, LLM'ler (OpenAI, özel OpenAI uyumlu uç nokta) (2026-11-15 tarihinde kontrol edildi)](https://docs.crewai.com/en/concepts/llms)
-   [CrewAI kaynak kodu, custom\_openai için LLM yönlendirmesi (llm.py) (2026-11-15 tarihinde kontrol edildi)](https://github.com/crewAIInc/crewAI/blob/main/lib/crewai/src/crewai/llm.py)
-   [PyPI, crewai 1.15.41, Python 3.10–3.13 (2026-11-15 tarihinde kontrol edildi)](https://pypi.org/project/crewai/)
-   [BroadNet Inference API referansı (2026-11-15 tarihinde kontrol edildi) (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-guides-crewai-custom-openai-endpoint&utm_content=sources)
