---
title: "Vercel AI SDK createOpenAICompatible ile özel base URL"
description: "Vercel AI SDK'da @ai-sdk/openai-compatible içindeki createOpenAICompatible ile BroadNet Inference'ı çağırın: generateText, streamText, araçlar ve reasoning effort."
url: https://broadrouter.com/tr/guides/vercel-ai-sdk-openai-compatible/
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/vercel-ai-sdk-openai-compatible/) (güncelleme: 2026-11-16).

# Vercel AI SDK'yı BroadNet Inference ile kullanın

Güncellendi 2026-11-16

ai ve @ai-sdk/openai-compatible paketlerini kurun, ardından createOpenAICompatible'ı name broadnet, baseURL https://inference.broadnet.ai/v1 ve apiKey olarak BroadNet anahtarınızla çağırın. Sağlayıcıya broadnet/glm-5.3 gibi bir BroadNet model kimliği verin ve generateText ya da streamText'i her zamanki gibi kullanın. Anahtarı sunucuda tutun, akıl yürütme modellerine cömert bir maxOutputTokens verin.

Vercel’in [AI SDK](https://ai-sdk.dev/providers/openai-compatible-providers) aracı, LLM uygulamaları için bir TypeScript araç setidir. `@ai-sdk/openai-compatible` paketi, OpenAI chat completions biçimini izleyen her API için bir sağlayıcı oluşturur. BroadNet Inference bu biçimi izlediğinden yalnızca base URL’yi, anahtarı ve model kimliklerini değiştirirsiniz. Bunun yerine düz OpenAI istemcisini kullanmak için [Node SDK rehberine](https://broadrouter.com/tr/guides/openai-node-sdk/) bakın.

## Kurulum

1.  **Paketleri kurun.** Bu yazı hazırlanırken npm, `ai` 7.x ve `@ai-sdk/openai-compatible` 3.x sürümlerini sunuyordu.
    
    ```bash
    npm install ai @ai-sdk/openai-compatible
    export BROADNET_API_KEY='your-broadnet-key'
    ```
    
2.  **Sağlayıcıyı oluşturun.**
    
    ```ts
    // broadnet.ts
    import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
    
    export const broadnet = createOpenAICompatible({
      name: 'broadnet',
      baseURL: 'https://inference.broadnet.ai/v1',
      apiKey: process.env.BROADNET_API_KEY,
      includeUsage: true, // usage data in streaming responses
    });
    ```
    
3.  **Metin üretin.**
    
    ```ts
    import { generateText } from 'ai';
    import { broadnet } from './broadnet';
    
    const { text, usage, finishReason } = await generateText({
      model: broadnet('broadnet/glm-5.3'),
      prompt: 'Explain idempotency keys in two sentences.',
      maxOutputTokens: 4000, // reasoning counts toward this
    });
    
    console.log(text, finishReason, usage);
    ```
    
4.  **Akışla alın.** `generateText` yerine `streamText` kullanın ve `textStream` değerini okuyun. Alttaki iletim biçimini [akış rehberi](https://broadrouter.com/tr/guides/streaming-chat-completions/) açıklar.
    

Verdiğiniz `name`, sağlayıcı seçenekleri ve sağlayıcı meta verisi için anahtar olur; bu yüzden kısa ve sabit tutun. `provider('id')` ve `provider.chatModel('id')` ikisi de bir sohbet modeli oluşturur; model başına ayrı kurulum yoktur. Anahtarı sunucuda tutun. Bu dosyayı tarayıcıda çalışan koda içe aktarmayın; aksi halde anahtar her ziyaretçiye gönderilir.

Sağlayıcı belgeleri metin üretimi, akış, araç çağırma, yapılandırılmış çıktılar, akıl yürütme içeriği ve görsel girdiyi desteklenen yetenekler olarak listeler ve bazılarının sağlayıcıya bağlı olduğunu not eder. BroadNet’te görsel girdi DeepSeek V4.1 Flash, Qwen3.8 27B ve Gemma 4 VL 26B ile çalışır. GLM 5.3 yalnızca metin alır.

## Ayarlamaya değer seçenekler

-   **reasoningEffort.** Sağlayıcı adını anahtar olarak kullanıp `providerOptions` üzerinden verin. AI SDK belgelerine göre geçerli değerler sağlayıcıya bağlıdır; BroadNet’in belgeleri `low` değerini gösterir.

```ts
const result = await generateText({
  model: broadnet('broadnet/deepseek-v4.1-flash'),
  prompt: 'Classify: "refund my order" -> intent?',
  providerOptions: { broadnet: { reasoningEffort: 'low' } },
});
```

-   **supportsStructuredOutputs.** AI SDK, JSON şemalarını yalnızca sağlayıcıda bu değer `true` olduğunda gönderir. BroadNet yapılandırılmış çıktıyı GLM 5.3 ve Qwen3.8 27B için listeler. Açarsanız şema çıktısı için bu modelleri kullanın.
-   **maxRetries.** `generateText` varsayılan olarak iki kez yeniden dener. Değeri hız sınırınıza göre ayarlayın.
-   **Akıl yürütme çıktısı.** AI SDK, sağlayıcı döndürdüğünde akıl yürütme içeriğini okur. Üst düzeydeki `reasoningText` sonuç alanı artık `finalStep.reasoningText` lehine kullanımdan kaldırılmış (deprecated) olarak işaretli. Akıl yürütmenin mutlaka bulunmasına dayanan mantık kurmayın.

## Hangi modeli seçmeli

| İhtiyaç | Model | Bağlam |
| --- | --- | --- |
| Araç çağırma, yapılandırılmış çıktı | [`broadnet/glm-5.3`](https://broadrouter.com/tr/models/glm-5.3/) | 1.048.576 |
| Görseller ve araçlar, Arapça | [`broadnet/qwen3.8-27b`](https://broadrouter.com/tr/models/qwen3.8-27b/) | 262.144 |
| Uzun bağlam, sabit fiyatlı plan | [`broadnet/deepseek-v4.1-flash`](https://broadrouter.com/tr/models/deepseek-v4.1-flash/) | 1.048.576 |
| Ucuz metin ve görsel çağrıları | [`broadnet/gemma-4-26b-a4b`](https://broadrouter.com/tr/models/gemma-4-vl-26b/) | 32.768 |

Her modelin token başına fiyatı [fiyatlandırma sayfasında](https://broadrouter.com/tr/pricing/).

## Sorun giderme

-   **401.** `BROADNET_API_KEY` çalışma ortamında yok (barındırma sağlayıcınızın ortam değişkeni ayarlarını kontrol edin), yanlış, süresi dolmuş ya da kullandıkça öde kullanım hakkı tükenmiş.
-   **providerOptions yok sayılıyor.** Anahtar, camelCase biçimindeki sağlayıcı `name` değeriyle eşleşmelidir. `name: 'broadnet'` ile `providerOptions.broadnet` kullanın.
-   **Model hataları.** Kimlik, `broadnet/` önekiyle birlikte BroadNet’tekiyle birebir aynı olmalı. GLM 5.3, Qwen3.8 27B ve DeepSeek V4.1 Flash bakiye yüklemesi gerektirir; $5 başlangıç kredisi yalnızca Gemma 4 VL 26B’yi kapsar.
-   **Boş metin, finishReason “length”.** Akıl yürütme bütçeyi tüketmiş. `maxOutputTokens` değerini artırın ya da `reasoningEffort` değerini düşürün. [Yanıtlar neden boş geliyor](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/).
-   **Yük altında 429.** Kullandıkça öde anahtarı dakikada 30 isteğe ve işlemde aynı anda 4 isteğe izin verir. Sunucusuz (serverless) fonksiyonlar hızla ölçeklenir; bu yüzden uygulamanızda eşzamanlılığı sınırlayın. [Hatalar ve yeniden denemeler](https://broadrouter.com/tr/guides/errors-and-retries/) rehberine bakın.
-   **Plan anahtarında paralel ajanlar.** Bir [sınırsız plan oturumu](https://broadrouter.com/tr/guides/unlimited-llm-api-sessions/) aynı anda tek istek çalıştırır. Birkaç ajan üzerinde `Promise.all` çalıştırmak için ajan başına bir oturum gerekir; aksi halde istekler sıraya girer.

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

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

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

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

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

[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

### @ai-sdk/openai mı kullanmalıyım, @ai-sdk/openai-compatible mı?

Üçüncü taraf OpenAI uyumlu API'ler için @ai-sdk/openai-compatible kullanın. Bu paket, BroadNet Inference'ın sunduğu chat completions uç noktasını çağırır.

### Üretilen metin neden boş?

BroadNet'te akıl yürütme max\_tokens sınırına dahildir. maxOutputTokens küçükse model yanıt başlamadan bütçenin tamamını harcayabilir. Değeri artırın ya da reasoningEffort'u low yapın.

### Akış sırasında token kullanımını nasıl alırım?

Sağlayıcıyı oluştururken includeUsage değerini true yapın. AI SDK belgelerine göre bu, akış yanıtlarına kullanım verisi ekler. Varsayılanı false'tur.

### Her BroadNet modeli için ayrı kurulum gerekir mi?

Hayır. Tek bir createOpenAICompatible sağlayıcısı tüm modelleri kapsar. Herhangi bir BroadNet sohbet modeli kimliğiyle broadnet('model-id') veya broadnet.chatModel('model-id') çağırın.

## İlgili rehberler

-   [OpenAI Node.js SDK'yı BroadNet Inference ile kullanın](https://broadrouter.com/tr/guides/openai-node-sdk/)
-   [Chat completions akışı ve kopan bağlantıları ele alma](https://broadrouter.com/tr/guides/streaming-chat-completions/)
-   [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'ı opencode'a özel sağlayıcı olarak ekleyin](https://broadrouter.com/tr/guides/opencode-custom-provider/)
-   [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-vercel-ai-sdk-openai-compatible&utm_content=page-cta) ·

**Kaynaklar**

-   [AI SDK belgeleri, OpenAI Compatible sağlayıcılar (2026-11-14 tarihinde kontrol edildi)](https://ai-sdk.dev/providers/openai-compatible-providers)
-   [AI SDK belgeleri, generateText referansı (2026-11-14 tarihinde kontrol edildi)](https://ai-sdk.dev/docs/reference/ai-sdk-core/generate-text)
-   [npm, @ai-sdk/openai-compatible paketi (3.x, 2026-11-14 tarihinde kontrol edildi)](https://www.npmjs.com/package/@ai-sdk/openai-compatible)
-   [BroadNet Inference API referansı (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-guides-vercel-ai-sdk-openai-compatible&utm_content=sources)
