---
title: "OpenAI Node.js SDK ile özel baseURL (BroadNet) | BroadRouter"
description: "Resmi OpenAI Node.js ve TypeScript SDK'yı baseURL ayarıyla BroadNet Inference'a yönlendirin. Kurun, ilk isteği gönderin, akış alın, istek kimliğini kaydedin."
url: https://broadrouter.com/tr/guides/openai-node-sdk/
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/openai-node-sdk/) (güncelleme: 2026-11-16).

# OpenAI Node.js SDK'yı BroadNet Inference ile kullanın

Güncellendi 2026-11-16

openai npm paketini kurun ve istemciyi baseURL değeri https://inference.broadnet.ai/v1, apiKey değeri BroadNet anahtarınız olacak şekilde oluşturun. Mevcut chat.completions kodunuz çalışmaya devam eder; yalnızca model kimliğini değiştirin, örneğin broadnet/deepseek-v4.1-flash. BroadNet Responses API'yi değil chat completions'ı sunar, bu yüzden client.chat.completions.create kullanmaya devam edin.

[BroadNet Inference hesabınızdan](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-guides-openai-node-sdk&utm_content=body) alacağınız bir çıkarım anahtarına ihtiyacınız var. Yeni hesaplar kart gerekmeden $5 krediyle başlar. Python kullanıyorsanız [Python SDK rehberine](https://broadrouter.com/tr/guides/openai-python-sdk/) bakın.

## 1\. Kurun ve anahtarı ayarlayın

Güncel `openai` paketi (7.x) Node.js 22 veya daha yenisini gerektirir.

```bash
npm install openai
export BROADNET_API_KEY='paste-the-key-once'
```

## 2\. İlk istek

`first-request.mjs` olarak kaydedin ve `node first-request.mjs` ile çalıştırın:

```js
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://inference.broadnet.ai/v1",
  apiKey: process.env.BROADNET_API_KEY,
});

const response = await client.chat.completions.create({
  model: "broadnet/gemma-4-26b-a4b",
  messages: [{ role: "user", content: "Reply with one short sentence." }],
});
console.log(response.choices[0].message.content);
```

`broadnet/gemma-4-26b-a4b` ücretsiz krediyle çalışır. Sınırsız plan modeli için `broadnet/deepseek-v4.1-flash` kullanın ve `max_tokens` değerini 1.000 veya daha yukarı ayarlayın, çünkü modelin akıl yürütmesi bu sınıra dahildir. [Yanıtlar neden boş geliyor](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/).

## 3\. Token akışı

```js
const stream = await client.chat.completions.create({
  model: "broadnet/deepseek-v4.1-flash",
  stream: true,
  stream_options: { include_usage: true },
  messages: [{ role: "user", content: "Count from one to three." }],
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
  if (chunk.usage) console.log("\n", chunk.usage);
}
```

## 4\. İstek kimliğini kaydedin

```js
const { data, request_id } = await client.chat.completions
  .create({ model: "broadnet/gemma-4-26b-a4b", messages: [{ role: "user", content: "Hi" }] })
  .withResponse();
console.log(request_id, data.choices[0].message.content);
```

SDK `request_id` değerini `x-request-id` başlığından okur. Ayrıştırılmış yanıtlar bu değeri `data._request_id` olarak da taşır.

Bu kimliği UTC saati, rota ve durum koduyla birlikte saklayın: BroadNet desteği bunları ister. [Hata kodları ve ne zaman yeniden denenmeli](https://broadrouter.com/tr/guides/errors-and-retries/).

## Sorun giderme

-   **401.** Anahtar yanlış, süresi dolmuş veya kullandıkça öde kullanım hakkı bitmiş. `BROADNET_API_KEY` tanımlı değilse `apiKey` değeri `undefined` olur ve SDK `OPENAI_API_KEY` değişkenine geri döner; o da yoksa hata fırlatır.
-   **404.** `baseURL` değerinin `/v1` ile bittiğini ve `responses` değil `chat.completions` çağırdığınızı kontrol edin. Ardından model kimliğini `broadnet/` önekiyle birlikte kontrol edin.
-   **Ücretli model yeni hesapta çalışmıyor.** $5 başlangıç kredisi BroadNet Gemma 4 VL 26B’yi (`broadnet/gemma-4-26b-a4b`) ve iki BroadNet Transcribe modelini kapsar. Diğer sohbet modellerini (DeepSeek V4.1 Flash, GLM 5.3 ve Qwen3.8 27B) kullanmak için bakiye yükleyin.
-   **Boş `content`.** Akıl yürütme `max_tokens` sınırına dahildir. Değeri artırın veya hiç ayarlamayın. [Yanıtlar neden boş geliyor](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/).
-   **429.** Kullandıkça öde anahtarı dakikada 30 isteğe ve aynı anda 4 isteğe izin verir. SDK varsayılan olarak iki kez yeniden dener; istemcide `maxRetries` ile ayarlayın. Kopan akışlar için bkz. [chat completions akışı](https://broadrouter.com/tr/guides/streaming-chat-completions/).

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

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

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

[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

### Node'da BroadNet base URL'sini ortam değişkeniyle ayarlayabilir miyim?

Evet. SDK, baseURL vermediğinizde OPENAI\_BASE\_URL değişkenini, apiKey vermediğinizde OPENAI\_API\_KEY değişkenini okur. İkisini de açıkça vermek, bir BroadNet anahtarını yanlışlıkla OpenAI'ye (ya da tersini) göndermenizi önler.

### client.responses.create BroadNet ile çalışır mı?

Hayır. BroadNet'in belgeleri yalnızca chat completions ve audio transcriptions uç noktalarını listeler. Sohbet için client.chat.completions.create kullanın.

### openai paketi hangi Node.js sürümünü gerektirir?

Güncel 7.x sürümü Node.js 22 veya daha yenisini şart koşar. Deno, Bun, Cloudflare Workers ve Vercel Edge de desteklenir.

### Node SDK ile BroadNet'i tarayıcıdan çağırabilir miyim?

Çağırmayın. dangerouslyAllowBrowser ayarlanmadıkça SDK tarayıcıda kullanımı engeller, çünkü anahtar her ziyaretçiye gönderilmiş olur. BroadNet'i bunun yerine sunucunuzdan çağırın.

## İlgili rehberler

-   [OpenAI Python SDK'yı BroadNet Inference ile kullanın](https://broadrouter.com/tr/guides/openai-python-sdk/)
-   [Chat completions akışı ve kopan bağlantıları ele alma](https://broadrouter.com/tr/guides/streaming-chat-completions/)
-   [BroadNet Inference hata kodları ve ne zaman yeniden denenmeli](https://broadrouter.com/tr/guides/errors-and-retries/)

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-openai-node-sdk&utm_content=page-cta) ·

**Kaynaklar**

-   [BroadNet Inference API referansı (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-guides-openai-node-sdk&utm_content=sources)
-   [npm'deki OpenAI Node.js kütüphanesi (7.x, Node.js 22+, 2026-11-14 tarihinde kontrol edildi)](https://www.npmjs.com/package/openai)
-   [openai-node README, istek kimlikleri ve gereksinimler (2026-11-14 tarihinde kontrol edildi)](https://github.com/openai/openai-node)
