---
title: "OpenAI Node.js SDK مع baseURL مخصّص (BroadNet) | BroadRouter"
description: "وجّه حزمة OpenAI SDK الرسمية لـ Node.js وTypeScript إلى BroadNet Inference بضبط baseURL: التثبيت وأول طلب وبث الرموز وتسجيل معرّفات الطلبات."
url: https://broadrouter.com/ar/guides/openai-node-sdk/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. [اقرأ الأصل الإنجليزي](https://broadrouter.com/guides/openai-node-sdk/) (حُدّث في 2026-11-16).

# استخدام OpenAI Node.js SDK مع BroadNet Inference

آخر تحديث 2026-11-16

ثبّت حزمة npm باسم openai، وأنشئ العميل مع ضبط baseURL على https://inference.broadnet.ai/v1 ووضع مفتاح BroadNet في apiKey. تظل شيفرة chat.completions الحالية تعمل؛ غيّر معرّف النموذج فقط، مثل broadnet/deepseek-v4.1-flash. يقدّم BroadNet إكمال المحادثات لا Responses API، فاستمر في استخدام client.chat.completions.create.

تحتاج إلى مفتاح استدلال من [حسابك في BroadNet Inference](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-openai-node-sdk&utm_content=body). تبدأ الحسابات الجديدة برصيد قدره $5 دون بطاقة دفع. وإذا كنت تستخدم Python، فراجع [دليل Python SDK](https://broadrouter.com/ar/guides/openai-python-sdk/).

## 1\. ثبّت الحزمة واضبط المفتاح

تتطلب الحزمة الحالية `openai` (الإصدار 7.x) الإصدار Node.js 22 أو أحدث.

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

## 2\. أول طلب

احفظ ما يلي في الملف `first-request.mjs` وشغّله بالأمر `node first-request.mjs`:

```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` بالرصيد المجاني. أما نموذج الخطة غير المحدودة فاستخدم له `broadnet/deepseek-v4.1-flash` واضبط `max_tokens` على 1,000 أو أكثر، لأن استدلاله المنطقي يُحتسب ضمن هذا الحد. [لماذا تصل الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).

## 3\. بثّ الرموز

```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\. سجّل معرّف الطلب

```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` من الترويسة `x-request-id`. وتحملها الاستجابات المحلَّلة أيضًا في `data._request_id`.

احتفظ بهذا المعرّف مع الوقت بتوقيت UTC والمسار ورمز الحالة، فدعم BroadNet يطلبها. [رموز الأخطاء ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).

## حل المشكلات

-   **401.** المفتاح خاطئ أو منتهي الصلاحية، أو استُنفدت حصة الدفع حسب الاستخدام. إذا لم يكن `BROADNET_API_KEY` مضبوطًا، فستكون قيمة `apiKey` هي `undefined`، وستلجأ حزمة SDK إلى `OPENAI_API_KEY`، أو تُطلق خطأً إذا كان هو الآخر غير موجود.
-   **404.** تأكّد من أن `baseURL` ينتهي بـ `/v1`، وأنك تستدعي `chat.completions` لا `responses`. ثم تحقّق من معرّف النموذج مع البادئة `broadnet/`.
-   **فشل نموذج مدفوع على حساب جديد.** يغطي الرصيد المبدئي البالغ $5 نموذج BroadNet Gemma 4 VL 26B (`broadnet/gemma-4-26b-a4b`) ونموذجَي BroadNet Transcribe. اشحن رصيدك لاستخدام نماذج المحادثة الأخرى: DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B.
-   **`content` فارغ.** يُحتسب الاستدلال المنطقي ضمن `max_tokens`. ارفعه أو اتركه دون ضبط. [لماذا تصل الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **429.** يسمح مفتاح الدفع حسب الاستخدام بما يصل إلى 30 من الطلبات في الدقيقة و4 من الطلبات في آنٍ واحد. تعيد حزمة SDK المحاولة مرتين افتراضيًا؛ اضبط `maxRetries` على العميل. وراجع [البث المتدفق لإكمال المحادثات](https://broadrouter.com/ar/guides/streaming-chat-completions/) لحالات انقطاع البث.

## مصطلحات في هذا الدليل

[الدفع حسب الاستخدام (Pay-as-you-go)](https://broadrouter.com/ar/glossary/pay-as-you-go/)

الدفع حسب الاستخدام هو نموذج تسعير تدفع فيه مقابل ما تستخدمه فقط، مقيسًا بوحدات مثل الرموز (التوكنات) أو الطلبات أو دقائق الصوت، دون اشتراك أو حد أدنى للالتزام. وتحتسب معظم واجهات LLM API تكلفتها بهذه الطريقة، من رصيد مدفوع مسبقًا أو بفاتورة دورية.

[التزامن (Concurrency)](https://broadrouter.com/ar/glossary/concurrency/)

التزامن (concurrency) هو عدد الطلبات التي تكون لدى العميل قيد التنفيذ في الوقت نفسه. وكثيرًا ما تضع واجهات LLM API سقفًا له لكل مفتاح أو خطة، بمعزل عن عدد الطلبات في الدقيقة، لأن كل طلب مفتوح يشغل قدرة من وحدة GPU حتى تكتمل استجابته.

[البث المتدفق (Streaming)](https://broadrouter.com/ar/glossary/streaming/)

البث المتدفق (streaming) طريقة لإرجاع استجابة النموذج اللغوي على أجزاء صغيرة أثناء توليدها، بدل إرجاعها ردًا واحدًا في النهاية. وتبث الواجهات المتوافقة مع OpenAI عبر أحداث يرسلها الخادم (server-sent events) حين يضبط الطلب stream على true.

[الرمز (التوكن، Token)](https://broadrouter.com/ar/glossary/token/)

الرمز (التوكن) هو وحدة النص التي يقرؤها نموذج اللغة ويكتبها: كلمة، أو جزء من كلمة، أو علامة ترقيم، أو تسلسل بايتات ينتجه مجزّئ النموذج (tokenizer). وتَعُدّ واجهات LLM API الاستهلاك بالرموز، وتضع حدودها بها، وتحتسب تكلفتها بها عادةً.

[حد المعدل (Rate limit)](https://broadrouter.com/ar/glossary/rate-limit/)

حد المعدل هو سقف تفرضه واجهة API على مقدار استخدام العميل لها خلال فترة زمنية، مثل عدد الطلبات في الدقيقة أو الرموز في الدقيقة. وتُرفض الطلبات التي تتجاوزه، غالبًا بالخطأ HTTP 429 Too Many Requests، إلى أن يعود الاستخدام تحت الحد.

## أسئلة شائعة

### هل يمكنني ضبط العنوان الأساسي لـ BroadNet بمتغير بيئة في Node؟

نعم. تقرأ حزمة SDK المتغير OPENAI\_BASE\_URL عندما لا تمرّر baseURL، والمتغير OPENAI\_API\_KEY عندما لا تمرّر apiKey. وتمرير القيمتين صراحةً يجنّبك إرسال مفتاح BroadNet إلى OpenAI، أو العكس، بالخطأ.

### هل تعمل client.responses.create مع BroadNet؟

لا. لا تذكر وثائق BroadNet سوى إكمال المحادثات وتفريغ الصوت. استخدم client.chat.completions.create للمحادثة.

### ما إصدار Node.js الذي تحتاجه حزمة openai؟

يشترط الإصدار الحالي 7.x الإصدار Node.js 22 أو أحدث. وتدعم الحزمة أيضًا Deno وBun وCloudflare Workers وVercel Edge.

### هل يمكنني استدعاء BroadNet من المتصفح بحزمة Node SDK؟

لا تفعل. تمنع حزمة SDK الاستخدام في المتصفح ما لم تضبط dangerouslyAllowBrowser، لأن المفتاح سيصل إلى كل زائر. استدعِ BroadNet من خادمك بدلًا من ذلك.

## أدلة ذات صلة

-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/)
-   [البث المتدفق لإكمال المحادثات والتعامل مع انقطاع الاتصال](https://broadrouter.com/ar/guides/streaming-chat-completions/)
-   [رموز أخطاء BroadNet Inference ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/)

جرّبه على مهامك الفعلية. تبدأ الحسابات الجديدة برصيد قدره $5 لاستخدام Gemma والتفريغ الصوتي. أما DeepSeek وGLM وQwen3.8 فتتطلب شحن الرصيد.

[ابدأ الآن](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-openai-node-sdk&utm_content=page-cta) ·

**المصادر**

-   [المرجع التقني لـ BroadNet Inference API (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-openai-node-sdk&utm_content=sources)
-   [مكتبة OpenAI لـ Node.js على npm (الإصدار 7.x، Node.js 22 فأحدث، رُوجع في 2026-11-14)](https://www.npmjs.com/package/openai)
-   [ملف README لـ openai-node: معرّفات الطلبات والمتطلبات (رُوجع في 2026-11-14)](https://github.com/openai/openai-node)
