تحتاج إلى مفتاح استدلال من حسابك في 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على العميل. وراجع البث المتدفق لإكمال المحادثات لحالات انقطاع البث.
