---
title: "Spring AI OpenAI starter ve özel base-url ayarı | BroadRouter"
description: "Spring AI'ın OpenAI sohbet starter'ını spring.ai.openai.base-url, BroadNet model kimliği ve max-tokens ile BroadNet Inference'a yönlendirin, ChatClient'tan çağırın."
url: https://broadrouter.com/tr/guides/spring-ai-openai-base-url/
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/spring-ai-openai-base-url/) (güncelleme: 2026-11-16).

# Spring AI'ı BroadNet Inference ile kullanın (OpenAI base-url)

Güncellendi 2026-11-16

spring-ai-starter-model-openai bağımlılığını ekleyin, ardından spring.ai.openai.base-url değerini https://inference.broadnet.ai/v1, spring.ai.openai.api-key değerini BroadNet anahtarınız, spring.ai.openai.chat.model değerini de broadnet/glm-5.3 gibi bir BroadNet kimliği yapın. spring.ai.openai.chat.max-tokens değerini akıl yürütmeye yer bırakacak şekilde ayarlayın. Spring AI 2.x, base URL'ye /chat/completions ekleyen openai-java SDK'sını kullanır.

Spring AI, Spring projesinin Java’da yapay zekâ için sunduğu framework’tür. OpenAI sohbet starter’ı bir `base-url` okur, bu yüzden OpenAI uyumlu her sunucuyu çağırabilir. BroadNet Inference `https://inference.broadnet.ai/v1` adresinde standart chat completions sunar. BroadRouter, BroadNet’in kendi sitesidir; bu rehber Spring AI 2.0.2 referansını izler.

## Starter’ı ekleyin

Spring AI BOM’u yerindeyken (Spring AI’ın bağımlılık yönetimi belgelerine bakın):

```xml
<dependency>
  <groupId>org.springframework.ai</groupId>
  <artifactId>spring-ai-starter-model-openai</artifactId>
</dependency>
```

## Yapılandırın

`application.properties`:

```properties
spring.ai.openai.base-url=https://inference.broadnet.ai/v1
spring.ai.openai.api-key=${BROADNET_API_KEY}
spring.ai.openai.chat.model=broadnet/glm-5.3
spring.ai.openai.chat.max-tokens=2000
```

```bash
export BROADNET_API_KEY='your-broadnet-key'
```

URL’de `/v1` kalsın. Spring AI 2.x’te değer openai-java istemcisine değiştirilmeden gider (`OpenAiSetup.calculateBaseUrl` onu olduğu gibi döndürür) ve `/chat/completions` ekini o istemci ekler. Değiştirdiği varsayılan değer `https://api.openai.com/v1`’dir.

## Çağırın ve test edin

```java
import org.springframework.ai.chat.client.ChatClient;
import org.springframework.boot.CommandLineRunner;
import org.springframework.context.annotation.Bean;

@Bean
CommandLineRunner smokeTest(ChatClient.Builder builder) {
    return args -> {
        ChatClient chat = builder.build();
        System.out.println(chat.prompt().user("Say hello in five words.").call().content());
    };
}
```

Uygulamayı başlatın. Bir yanıt yazdırılırsa anahtar, URL ve model kimliği doğrudur.

## BroadNet için önemli ayarlar

-   **`max-completion-tokens` değil, `max-tokens`.** Spring AI’ın belgeleri ikisinin birbirini dışladığını ve ikisini birden ayarlamanın hata olduğunu söyler. BroadNet’in API referansı `max_tokens` alanını tanımlar. DeepSeek V4.1 Flash, GLM 5.3 ve Qwen3.8 27B önce akıl yürütür ve akıl yürütme bu sınıra dahildir.
-   **Akıl yürütme metni.** Spring AI, `reasoning_content` döndüren OpenAI uyumlu sunuculardan bu alanı sunabilir. BroadNet’in API referansı `usage` içinde akıl yürütme token sayılarını raporlar ama akıl yürütme metninin kendisini vaat etmez; buna güvenmeyin.
-   **Yalnızca sohbet için geçersiz kılma.** `spring.ai.openai.chat.base-url` ve `spring.ai.openai.chat.api-key`, sohbet modeli için ortak özelliklerin önüne geçer. Diğer Spring AI OpenAI modellerinin (örneğin embedding) OpenAI’da kalması gerekiyorsa bunları kullanın.
-   **Yeniden denemeler.** `spring.ai.retry.max-attempts` varsayılan olarak üstel geri çekilmeyle 10’dur. Kullandıkça öde anahtarında bu, dakika başı sınırı hızla tüketebilir; düşürmeyi düşünün.

## Hangi modeli seçmeli

| Kullanım | `spring.ai.openai.chat.model` |
| --- | --- |
| Araç çağırma, yapılandırılmış çıktı | `broadnet/glm-5.3` |
| Görseller veya Arapça metin | `broadnet/qwen3.8-27b` |
| Uzun belgeler, sabit fiyatlı plan | `broadnet/deepseek-v4.1-flash` |
| Ücretsiz başlangıç kredisi | `broadnet/gemma-4-26b-a4b` |

[Tüm modellerin fiyatları](https://broadrouter.com/tr/pricing/).

## Sorun giderme

-   **401.** Anahtar yanlış, süresi dolmuş ya da kullanım hakkı tükenmiş veya `BROADNET_API_KEY` JVM için ayarlanmamış.
-   **404.** Base URL’de `/v1` eksik ya da model kimliği yanlış. Ücretli modeller bakiye yüklemesi gerektirir; $5 kredisi yalnızca `broadnet/gemma-4-26b-a4b` modelini kapsar.
-   **Boş `content()`.** Akıl yürütme çıktı bütçesini tüketmiş. `max-tokens` değerini artırın. [Yanıtlar neden boş geliyor](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/).
-   **İki token sınırı birden ayarlıyken 400.** `max-completion-tokens` ayarını kaldırın.
-   **429.** Kullandıkça öde anahtarı dakikada 30 isteğe ve aynı anda işlemde 4 isteğe izin verir. [Hatalar ve yeniden denemeler](https://broadrouter.com/tr/guides/errors-and-retries/) rehberine bakın.

## Bu rehberdeki terimler

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

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

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

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

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

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

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

[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

### spring.ai.openai.base-url /v1 içermeli mi?

Evet. Spring AI 2.x'te değer, kendi varsayılanı https://api.openai.com/v1 olan openai-java istemcisine değiştirilmeden aktarılır. https://inference.broadnet.ai/v1 kullanın.

### BroadNet ile max-tokens mı, max-completion-tokens mı kullanmalıyım?

max-tokens. Spring AI'ın belgeleri ikisinin birbirini dışladığını söyler. BroadNet'in API referansı max\_tokens alanını tanımlar ve akıl yürütme bu sınıra dahildir; bu yüzden 1.000 token veya daha fazlasına izin verin.

### Spring AI araç çağırma BroadNet ile çalışır mı?

BroadNet'in araç desteğiyle listelediği GLM 5.3 veya Qwen3.8 27B'yi kullanın. BroadNet'in belgeleri DeepSeek V4.1 Flash için araç çağırmayı listelemez.

### Embedding için OpenAI'da kalıp sohbet için BroadNet kullanabilir miyim?

Evet. spring.ai.openai.chat.base-url ve spring.ai.openai.chat.api-key, ortak özellikleri yalnızca sohbet modeli için geçersiz kılar. BroadNet'in API referansı bir embedding uç noktası listelemez.

## İlgili rehberler

-   [BroadNet Inference'ı Go'dan openai-go SDK ile çağırın](https://broadrouter.com/tr/guides/openai-go-sdk/)
-   [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-spring-ai-openai-base-url&utm_content=page-cta) ·

**Kaynaklar**

-   [Spring AI referansı, OpenAI Chat (2.0.2) (2026-11-15 tarihinde kontrol edildi)](https://docs.spring.io/spring-ai/reference/api/chat/openai-chat.html)
-   [Spring AI kaynak kodu, v2.0.2 sürümünde OpenAiSetup.calculateBaseUrl (2026-11-16 tarihinde kontrol edildi)](https://github.com/spring-projects/spring-ai/blob/v2.0.2/models/spring-ai-openai/src/main/java/org/springframework/ai/openai/setup/OpenAiSetup.java)
-   [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-spring-ai-openai-base-url&utm_content=sources)
