---
title: "Mastra özel OpenAI uyumlu uç nokta (model url) | BroadRouter"
description: "Mastra ajanlarını id, url ve apiKey içeren bir model nesnesiyle BroadNet Inference'ta çalıştırın; model kimliğinin gerektirdiği çift broadnet/ önekiyle birlikte."
url: https://broadrouter.com/tr/guides/mastra-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/mastra-openai-compatible/) (güncelleme: 2026-11-16).

# Mastra ajanlarını BroadNet Inference ile kullanın

Güncellendi 2026-11-16

Bir Mastra Agent'ta model değerini şu nesne yapın: url https://inference.broadnet.ai/v1, apiKey BROADNET\_API\_KEY'den ve id broadnet/broadnet/glm-5.3. Mastra id'nin ilk bölümünü sağlayıcı adı sayıp atar; çift önek sayesinde BroadNet'e broadnet/glm-5.3 gider. Özel URL'ler varsayılan olarak chat completions kullanır. Araçlar için GLM 5.3 veya Qwen3.8 27B kullanın.

Mastra, yapay zekâ ajanları ve iş akışları (workflow) için bir TypeScript framework’üdür. Yerleşik sağlayıcılarının yanı sıra bir ajanın `model` değeri, `id` ve `url` içeren bir nesne olarak verilen herhangi bir OpenAI uyumlu uç nokta olabilir. BroadNet Inference standart chat completions isteklerini `https://inference.broadnet.ai/v1` adresinde sunduğu için bu yolla çalışır; model kimliğinde yalnızca bir püf noktası var. BroadRouter, BroadNet’in kendi sitesidir; bu rehber [Mastra’nın model belgelerini](https://mastra.ai/models) ve @mastra/core 1.83.0’ı izler.

## Kurulum

```bash
npm install @mastra/core zod
export BROADNET_API_KEY='your-broadnet-key'
```

## Bir ajan bağlayın

```ts
import { Agent } from "@mastra/core/agent";

const broadnet = (model: string) => ({
  id: `broadnet/${model}`,              // Mastra strips the first segment
  url: "https://inference.broadnet.ai/v1",
  apiKey: process.env.BROADNET_API_KEY,
});

export const assistant = new Agent({
  id: "assistant",
  name: "Assistant",
  instructions: "You are a concise assistant.",
  model: broadnet("broadnet/glm-5.3"),     // sends broadnet/glm-5.3
});

const res = await assistant.generate("Give me three names for a Go linting tool.");
console.log(res.text);
```

### Neden çift önek

Mastra belgelerine göre `provider/model` biçiminde yazılan bir `id`, uzak sunucuya yalın model adını gönderir; `gateway/provider/model` biçimi ise sağlayıcıyı adda tutar. BroadNet kimlikleri eğik çizgi içerdiği için daha uzun biçime ihtiyaç duyar. Testimizde:

| Mastra `id` | BroadNet’e ulaşan model kimliği |
| --- | --- |
| `broadnet/glm-5.3` | `glm-5.3` (yanlış) |
| `broadnet/broadnet/glm-5.3` | `broadnet/glm-5.3` (doğru) |

Yukarıdaki yardımcı fonksiyon fazladan bölümü sizin yerinize ekler.

## Araçlar

```ts
import { createTool } from "@mastra/core/tools";
import { z } from "zod";

const weather = createTool({
  id: "get_weather",
  description: "Get the weather for a city",
  inputSchema: z.object({ city: z.string() }),
  execute: async (input) => ({ city: input.city, tempC: 21 }),
});

const agent = new Agent({
  id: "weather",
  name: "Weather",
  instructions: "Use the weather tool to answer.",
  tools: { weather },
  model: broadnet("broadnet/glm-5.3"),
});
```

Araç kullanan ajanlar için `broadnet/glm-5.3` veya `broadnet/qwen3.8-27b` kullanın. BroadNet’in belgeleri araçları ve yapılandırılmış çıktıyı yalnızca bu iki model için listeler.

## Akış (streaming)

```ts
const stream = await assistant.stream("Explain vector search in two sentences.");
for await (const chunk of stream.textStream) process.stdout.write(chunk);
```

## Önemli ayarlar

-   **`url`** base URL’dir ve `/v1` ile biter. Mastra `/chat/completions` yolunu ekler.
-   **`api: "responses"` eklemeyin.** Mastra belgelerine göre bu ayar `/v1/responses` uç noktasına geçirir. BroadNet Responses API’yi listelemez.
-   **Çıktı sınırı.** 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 çıktı sınırına dahildir. Çıktı token’larını sınırlıyorsanız 2.000 veya daha fazla bırakın.

## Hangi modeli seçmeli

| Ajan | Model |
| --- | --- |
| Araçlar, yapılandırılmış çıktı, iş akışları | `broadnet/glm-5.3` |
| Araçlar artı görsel girdi veya Arapça metin | `broadnet/qwen3.8-27b` |
| Sabit fiyatlı planda yalnızca metin adımları | `broadnet/deepseek-v4.1-flash` |

[Tüm modellerin fiyatları](https://broadrouter.com/tr/pricing/). Mastra olmadan Vercel AI SDK için [AI SDK rehberine](https://broadrouter.com/tr/guides/vercel-ai-sdk-openai-compatible/) bakın.

## Bunu nasıl test ettik

2026-11-15’te Node 24 ile @mastra/core 1.83.0’ı kurduk ve `generate`, `stream` ile araç kullanan bir ajanı, BroadNet’in chat completions yapısını konuşan ve araç çağrıları döndüren yerel bir mock sunucuya karşı çalıştırdık. Kaydedilen istekleri okuduk. Her çağrı `/v1/chat/completions` adresine, `apiKey` değerinden gelen bir Bearer anahtarıyla gitti. Yukarıdaki tablodaki önek kuralını da böyle bulduk. Elimizde bir BroadNet anahtarı yoktu; bu yüzden gerçek model çıktısını test etmedik.

## Sorun giderme

-   **404 veya model bulunamadı.** Model kimliği büyük olasılıkla önekini kaybetti. `id` değerini `broadnet/broadnet/glm-5.3` olarak yazın. Ardından `url` değerinin `/v1` ile bittiğini kontrol edin. Ücretli modeller bakiye yüklemesi gerektirir; $5 kredi yalnızca `broadnet/gemma-4-26b-a4b` modelini ve iki Transcribe modelini kapsar.
-   **401.** `BROADNET_API_KEY` süreçte tanımlı değil ya da anahtar yanlış veya kullanım hakkı tükenmiş.
-   **Boş yanıtlar.** Akıl yürütme çıktı bütçesini tüketti. [Yanıtlar neden boş geliyor](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/).
-   **Paralel adımlı iş akışlarında 429.** Kullandıkça öde anahtarı dakikada 30 isteğe ve aynı anda 4 işlemdeki isteğe izin verir; bir plan oturumu ise istekleri tek tek çalıştırır. [Hatalar ve yeniden denemeler](https://broadrouter.com/tr/guides/errors-and-retries/) rehberine bakın.

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

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

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

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

[Girdi ve çıktı token'ları](https://broadrouter.com/tr/glossary/input-and-output-tokens/)

Girdi token'ları, bir dil modelinin istekte okuduğu token'lardır: sistem istemi, konuşma geçmişi, araç tanımları ve görseller dahil. Çıktı token'ları ise modelin yanıt olarak ürettikleridir, akıl yürütme dahil. LLM API'leri bunları genellikle ayrı fiyatlandırır ve çıktı genellikle daha pahalıdır.

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

## Sık sorulan sorular

### Mastra neden broadnet/glm-5.3 yerine glm-5.3 gönderiyor?

Mastra model id'sini sağlayıcı/model olarak okur ve yalnızca ilk eğik çizgiden sonraki kısmı gönderir. Testimizde broadnet/glm-5.3 id'siyle glm-5.3 gönderdi; BroadNet bunu tanımaz. id'yi broadnet/broadnet/glm-5.3 olarak yazın.

### Mastra url değeri base URL mi olmalı, chat completions URL'si mi?

Base URL. Mastra belgeleri OpenAI uyumlu uç noktanın base URL'sinin kullanılmasını söyler; yani /chat/completions olmadan https://inference.broadnet.ai/v1 kullanın.

### Mastra özel bir URL ile Responses API'yi mi kullanır?

Varsayılan olarak hayır. Mastra belgelerine göre api değerini responses olarak eklemediğiniz sürece özel uç noktalar chat completions kullanır. Chat completions sunan BroadNet için bunu eklemeyin.

### Mastra araçları BroadNet'te çalışıyor mu?

Evet; BroadNet'in araç desteğiyle listelediği bir modelde, yani GLM 5.3 veya Qwen3.8 27B'de. Mock testimizde ajan araç şemasını gönderdi, aracı çalıştırdı ve sonucu döndürdü.

## İlgili rehberler

-   [Vercel AI SDK'yı BroadNet Inference ile kullanın](https://broadrouter.com/tr/guides/vercel-ai-sdk-openai-compatible/)
-   [OpenAI Node.js SDK'yı BroadNet Inference ile kullanın](https://broadrouter.com/tr/guides/openai-node-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-mastra-openai-compatible&utm_content=page-cta) ·

**Kaynaklar**

-   [Mastra belgeleri, Models (özel OpenAI uyumlu uç noktalar) (2026-11-15 tarihinde kontrol edildi)](https://mastra.ai/models)
-   [GitHub'da Mastra, @mastra/core 1.83.0 sürümü, 2026-11-13 (2026-11-15 tarihinde kontrol edildi)](https://github.com/mastra-ai/mastra/releases/tag/%40mastra%2Fcore%401.83.0)
-   [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-mastra-openai-compatible&utm_content=sources)
