---
title: "Vercel AI SDK: createOpenAICompatible مع base URL مخصّص"
description: "استدعِ BroadNet Inference من Vercel AI SDK عبر createOpenAICompatible من الحزمة @ai-sdk/openai-compatible: generateText وstreamText والأدوات ومستوى الاستدلال."
url: https://broadrouter.com/ar/guides/vercel-ai-sdk-openai-compatible/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# استخدام Vercel AI SDK مع BroadNet Inference

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

ثبّت الحزمتين ai و@ai-sdk/openai-compatible، ثم استدعِ createOpenAICompatible مع name بالقيمة broadnet، وbaseURL بالقيمة https://inference.broadnet.ai/v1، ومفتاح BroadNet في apiKey. مرّر إلى المزوّد معرّف نموذج من BroadNet مثل broadnet/glm-5.3، واستخدم generateText أو streamText كالمعتاد. أبقِ المفتاح على الخادم، وامنح نماذج الاستدلال المنطقي قيمة سخية في maxOutputTokens.

[AI SDK](https://ai-sdk.dev/providers/openai-compatible-providers) من Vercel مجموعة أدوات TypeScript لتطبيقات LLM. وتُنشئ حزمتها `@ai-sdk/openai-compatible` مزوّدًا لأي واجهة API تتبع صيغة chat completions من OpenAI. وBroadNet Inference تتبعها، فلا تغيّر سوى base URL والمفتاح ومعرّفات النماذج. وإن أردت عميل OpenAI العادي بدلًا من ذلك، فراجع [دليل Node SDK](https://broadrouter.com/ar/guides/openai-node-sdk/).

## الإعداد

1.  **ثبّت الحزم.** وقت كتابة هذا الدليل، يقدّم npm الإصدار 7.x من `ai` والإصدار 3.x من `@ai-sdk/openai-compatible`.
    
    ```bash
    npm install ai @ai-sdk/openai-compatible
    export BROADNET_API_KEY='your-broadnet-key'
    ```
    
2.  **أنشئ المزوّد.**
    
    ```ts
    // broadnet.ts
    import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
    
    export const broadnet = createOpenAICompatible({
      name: 'broadnet',
      baseURL: 'https://inference.broadnet.ai/v1',
      apiKey: process.env.BROADNET_API_KEY,
      includeUsage: true, // usage data in streaming responses
    });
    ```
    
3.  **ولّد النص.**
    
    ```ts
    import { generateText } from 'ai';
    import { broadnet } from './broadnet';
    
    const { text, usage, finishReason } = await generateText({
      model: broadnet('broadnet/glm-5.3'),
      prompt: 'Explain idempotency keys in two sentences.',
      maxOutputTokens: 4000, // reasoning counts toward this
    });
    
    console.log(text, finishReason, usage);
    ```
    
4.  **بثّ الإجابة.** ضع `streamText` مكان `generateText` واقرأ `textStream`. ويشرح [دليل البث المتدفق](https://broadrouter.com/ar/guides/streaming-chat-completions/) صيغة البيانات المنقولة تحت ذلك.
    

تصبح قيمة `name` التي تمرّرها مفتاحًا لخيارات المزوّد وبياناته الوصفية، لذا اجعلها قصيرة وثابتة. وكلٌّ من `provider('id')` و`provider.chatModel('id')` يُنشئ نموذج محادثة؛ ولا يوجد إعداد منفصل لكل نموذج. أبقِ المفتاح على الخادم، ولا تستورد هذا الملف في شيفرة تعمل في المتصفح، وإلا وصل المفتاح إلى كل زائر.

يُدرج توثيق المزوّد توليد النصوص، والبث، واستدعاء الأدوات، والمخرجات المنظَّمة، ومحتوى الاستدلال المنطقي، وإدخال الصور ضمن القدرات المدعومة، مع ملاحظة أن بعضها يعتمد على المزوّد. وفي BroadNet، يعمل إدخال الصور مع DeepSeek V4.1 Flash وQwen3.8 27B وGemma 4 VL 26B، بينما يقبل GLM 5.3 النصوص فقط.

## خيارات تستحق الضبط

-   **reasoningEffort.** مرّره عبر `providerOptions` تحت مفتاح باسم المزوّد. يقول توثيق AI SDK إن القيم الدقيقة تعتمد على المزوّد؛ ويعرض توثيق BroadNet القيمة `low`.

```ts
const result = await generateText({
  model: broadnet('broadnet/deepseek-v4.1-flash'),
  prompt: 'Classify: "refund my order" -> intent?',
  providerOptions: { broadnet: { reasoningEffort: 'low' } },
});
```

-   **supportsStructuredOutputs.** لا يرسل AI SDK مخططات JSON إلا حين تكون هذه القيمة `true` على المزوّد. وتُدرج BroadNet المخرجات المنظَّمة لنموذجَي GLM 5.3 وQwen3.8 27B، فإن فعّلتها فاستخدم هذين النموذجين للمخرجات المقيّدة بمخطط.
-   **maxRetries.** تعيد `generateText` المحاولة مرتين افتراضيًا. اضبطها بما يناسب حد المعدل لديك.
-   **مخرجات الاستدلال المنطقي.** يقرأ AI SDK محتوى الاستدلال المنطقي حين يُرجعه المزوّد. والحقل `reasoningText` في المستوى الأعلى من النتيجة مُعلَّم الآن بأنه مُهمَل لصالح `finalStep.reasoningText`. لا تبنِ منطقًا يفترض وجود الاستدلال المنطقي.

## أي نموذج تختار

| الحاجة | النموذج | السياق |
| --- | --- | --- |
| استدعاء الأدوات، والمخرجات المنظَّمة | [`broadnet/glm-5.3`](https://broadrouter.com/ar/models/glm-5.3/) | 1,048,576 |
| الصور مع الأدوات، والعربية | [`broadnet/qwen3.8-27b`](https://broadrouter.com/ar/models/qwen3.8-27b/) | 262,144 |
| السياق الطويل، والخطة ثابتة السعر | [`broadnet/deepseek-v4.1-flash`](https://broadrouter.com/ar/models/deepseek-v4.1-flash/) | 1,048,576 |
| استدعاءات نصوص وصور رخيصة | [`broadnet/gemma-4-26b-a4b`](https://broadrouter.com/ar/models/gemma-4-vl-26b/) | 32,768 |

أسعار كل نموذج لكل رمز في [صفحة الأسعار](https://broadrouter.com/ar/pricing/).

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

-   **401.** المتغيّر `BROADNET_API_KEY` غير موجود في بيئة التشغيل (راجع إعدادات متغيّرات البيئة لدى مزوّد الاستضافة)، أو المفتاح خاطئ أو منتهي الصلاحية أو استنفد رصيد الدفع حسب الاستخدام.
-   **تجاهُل providerOptions.** يجب أن يطابق المفتاح قيمة `name` للمزوّد بصيغة camelCase. فمع `name: 'broadnet'` استخدم `providerOptions.broadnet`.
-   **أخطاء النموذج.** يجب أن يطابق المعرّف معرّف BroadNet تمامًا، مع البادئة `broadnet/`. تحتاج نماذج GLM 5.3 وQwen3.8 27B وDeepSeek V4.1 Flash إلى شحن الرصيد؛ أما الرصيد المبدئي البالغ $5 فيغطي Gemma 4 VL 26B ونموذجَي Transcribe.
-   **نص فارغ مع finishReason بالقيمة “length”.** استهلك الاستدلال المنطقي الميزانية. ارفع `maxOutputTokens` أو اخفض `reasoningEffort`. راجع [لماذا تعود الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **الخطأ 429 تحت الضغط.** يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ. والدوال عديمة الخادم (serverless) تتوسّع بسرعة، لذا ضع سقفًا للتزامن في تطبيقك. راجع [الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).
-   **وكلاء متوازون على مفتاح خطة.** [جلسة الخطة غير المحدودة](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/) الواحدة تشغّل طلبًا واحدًا في كل مرة. وتشغيل `Promise.all` على عدة وكلاء يحتاج إلى جلسة لكل وكيل، وإلا انتظرت الطلبات في طابور.

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

[استدعاء الأدوات (Tool calling)](https://broadrouter.com/ar/glossary/tool-calling/)

استدعاء الأدوات، ويُسمّى أيضًا استدعاء الدوال (function calling)، ميزة في واجهات LLM API يُرجع فيها النموذج طلبًا منظَّمًا لتشغيل دالة عرّفها المطوّر، مع معاملات بصيغة JSON. ويشغّل التطبيق الدالة ويعيد النتيجة؛ فالنموذج لا يشغّل الشيفرة بنفسه أبدًا.

[الدفع حسب الاستخدام (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 حتى تكتمل استجابته.

[العنوان الأساسي (Base URL)](https://broadrouter.com/ar/glossary/base-url/)

العنوان الأساسي (base URL) هو الجذر الثابت لعنوان الواجهة، مثل https://api.example.com/v1، الذي يضعه العميل قبل كل مسار نقطة نهاية، مثل /chat/completions. وفي حزم SDK المتوافقة مع OpenAI، يكفي تغيير العنوان الأساسي، مع مفتاح API ومعرّف النموذج، لتوجيه الشيفرة نفسها إلى مزوّد آخر.

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

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

[الاستدلال بلا خوادم (Serverless inference)](https://broadrouter.com/ar/glossary/serverless-inference/)

الاستدلال بلا خوادم طريقة لتشغيل نماذج تعلّم الآلة تبدأ فيها المنصة موارد الحوسبة خلف نقطة النهاية وتوسّعها وتوقفها تلقائيًا، وغالبًا حتى الصفر عند الخمول، وتحاسبك على الاستخدام لا على أجهزة محجوزة. والثمن هو احتمال تأخير البدء البارد.

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

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

[الرصيد المدفوع مسبقًا (Prepaid credit)](https://broadrouter.com/ar/glossary/prepaid-credit/)

الرصيد المدفوع مسبقًا هو مال يُضاف إلى حساب API قبل الاستخدام. يُخصم من الرصيد ثمن كل طلب، وعندما ينفد الرصيد تتوقف الطلبات المحتسبة بالاستهلاك حتى تشحن رصيدك. وهو يحصر الإنفاق في حدود ما دفعته.

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

### هل أستخدم @ai-sdk/openai أم @ai-sdk/openai-compatible؟

استخدم @ai-sdk/openai-compatible لواجهات API المتوافقة مع OpenAI من جهات أخرى. فهي تستدعي نقطة نهاية chat completions، وهي ما تقدّمه BroadNet Inference.

### لماذا يكون النص المولَّد فارغًا؟

يُحتسب الاستدلال المنطقي ضمن max\_tokens في BroadNet. فإن كانت قيمة maxOutputTokens صغيرة، فقد يستهلكها النموذج كلها قبل أن تبدأ الإجابة. ارفعها أو اضبط reasoningEffort على low.

### كيف أحصل على استخدام الرموز أثناء البث؟

اضبط includeUsage على true عند إنشاء المزوّد. يقول توثيق AI SDK إنه يضيف بيانات الاستخدام إلى الاستجابات المتدفقة، وقيمته الافتراضية false.

### هل أحتاج إلى إعداد منفصل لكل نموذج من BroadNet؟

لا. مزوّد واحد من createOpenAICompatible يغطي كل النماذج. استدعِ broadnet('model-id') أو broadnet.chatModel('model-id') بأي معرّف لنموذج محادثة من BroadNet.

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

-   [استخدام OpenAI Node.js SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-node-sdk/)
-   [البث المتدفق لإكمال المحادثات والتعامل مع انقطاع الاتصال](https://broadrouter.com/ar/guides/streaming-chat-completions/)
-   [لماذا يعيد نموذج الاستدلال إجابة فارغة؟](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/)
-   [إضافة BroadNet Inference إلى opencode كمزوّد مخصّص](https://broadrouter.com/ar/guides/opencode-custom-provider/)
-   [كل الأدوات التي تعمل مع BroadNet Inference (بالإنجليزية)](https://broadrouter.com/integrations/): حِزم SDK ووكلاء البرمجة وواجهات الدردشة وأدوات الأتمتة، مع الإعدادات الدقيقة لكل منها

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

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

**المصادر**

-   [توثيق AI SDK، المزوّدون المتوافقون مع OpenAI (رُوجع في 2026-11-14)](https://ai-sdk.dev/providers/openai-compatible-providers)
-   [توثيق AI SDK، مرجع generateText (رُوجع في 2026-11-14)](https://ai-sdk.dev/docs/reference/ai-sdk-core/generate-text)
-   [npm، حزمة @ai-sdk/openai-compatible (الإصدار 3.x، رُوجعت في 2026-11-14)](https://www.npmjs.com/package/@ai-sdk/openai-compatible)
-   [المرجع التقني لـ BroadNet Inference API (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-vercel-ai-sdk-openai-compatible&utm_content=sources)
