BroadRouter
ابدأ الآن

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

آخر تحديث

ثبّت حزمة 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. تبدأ الحسابات الجديدة برصيد قدره $5 دون بطاقة دفع. وإذا كنت تستخدم Python، فراجع دليل Python SDK.

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

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

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

2. أول طلب

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

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 أو أكثر، لأن استدلاله المنطقي يُحتسب ضمن هذا الحد. لماذا تصل الإجابات فارغة.

3. بثّ الرموز

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

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 يطلبها. رموز الأخطاء ومتى تعيد المحاولة.

حل المشكلات

  • 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. ارفعه أو اتركه دون ضبط. لماذا تصل الإجابات فارغة.
  • 429. يسمح مفتاح الدفع حسب الاستخدام بما يصل إلى 30 من الطلبات في الدقيقة و4 من الطلبات في آنٍ واحد. تعيد حزمة SDK المحاولة مرتين افتراضيًا؛ اضبط maxRetries على العميل. وراجع البث المتدفق لإكمال المحادثات لحالات انقطاع البث.

أسئلة شائعة

هل يمكنني ضبط العنوان الأساسي لـ 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 من خادمك بدلًا من ذلك.

اقرأها بصيغة Markdownاسأل ChatGPTاسأل Claudeاسأل Perplexity