---
title: "Spring AI مع OpenAI starter و base-url مخصّص | BroadRouter"
description: "وجّه OpenAI chat starter في Spring AI إلى BroadNet Inference عبر spring.ai.openai.base-url ومعرّف نموذج من BroadNet وmax-tokens، ثم استدعه من ChatClient."
url: https://broadrouter.com/ar/guides/spring-ai-openai-base-url/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# استخدام Spring AI مع BroadNet Inference (OpenAI base-url)

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

أضف spring-ai-starter-model-openai، ثم اضبط spring.ai.openai.base-url على https://inference.broadnet.ai/v1، وspring.ai.openai.api-key على مفتاح BroadNet، وspring.ai.openai.chat.model على معرّف من BroadNet مثل broadnet/glm-5.3. واضبط spring.ai.openai.chat.max-tokens مع ترك مساحة للاستدلال. يستخدم Spring AI 2.x حزمة openai-java SDK، التي تُلحق /chat/completions بالرابط الأساسي.

Spring AI هو إطار عمل مشروع Spring للذكاء الاصطناعي في Java. ويقرأ OpenAI chat starter فيه قيمة `base-url`، فيمكنه استدعاء أي خادم متوافق مع OpenAI. وتقدّم BroadNet Inference واجهة chat completions القياسية على `https://inference.broadnet.ai/v1`. BroadRouter هو موقع BroadNet نفسها؛ ويتبع هذا الدليل مرجع Spring AI 2.0.2.

## أضف الـ starter

بعد إعداد Spring AI BOM (راجع توثيق إدارة الاعتماديات في Spring AI):

```xml
<dependency>
  <groupId>org.springframework.ai</groupId>
  <artifactId>spring-ai-starter-model-openai</artifactId>
</dependency>
```

## الإعداد

الملف `application.properties`:

```properties
spring.ai.openai.base-url=https://inference.broadnet.ai/v1
spring.ai.openai.api-key=${BROADNET_API_KEY}
spring.ai.openai.chat.model=broadnet/glm-5.3
spring.ai.openai.chat.max-tokens=2000
```

```bash
export BROADNET_API_KEY='your-broadnet-key'
```

أبقِ `/v1` في الرابط. ففي Spring AI 2.x تذهب القيمة إلى عميل openai-java دون تغيير (إذ تعيدها `OpenAiSetup.calculateBaseUrl` كما هي)، وذلك العميل يضيف `/chat/completions`. والقيمة الافتراضية التي تستبدلها هي `https://api.openai.com/v1`.

## الاستدعاء والاختبار

```java
import org.springframework.ai.chat.client.ChatClient;
import org.springframework.boot.CommandLineRunner;
import org.springframework.context.annotation.Bean;

@Bean
CommandLineRunner smokeTest(ChatClient.Builder builder) {
    return args -> {
        ChatClient chat = builder.build();
        System.out.println(chat.prompt().user("Say hello in five words.").call().content());
    };
}
```

شغّل التطبيق. فإن طُبعت إجابة، فالمفتاح والرابط ومعرّف النموذج صحيحة.

## إعدادات مهمة مع BroadNet

-   **`max-tokens` لا `max-completion-tokens`.** يقول توثيق Spring AI إنهما لا يجتمعان وإن ضبطهما معًا خطأ. ويصف المرجع التقني لـ BroadNet API الحقل `max_tokens`. وتستدل نماذج DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B أولًا، ويُحتسب الاستدلال ضمن الحد.
-   **نص الاستدلال.** يستطيع Spring AI عرض `reasoning_content` من الخوادم المتوافقة مع OpenAI التي تعيده. ويُبلغ المرجع التقني لـ BroadNet API عن أعداد رموز الاستدلال في `usage`، لكنه لا يَعِد بإعادة نص الاستدلال نفسه، فلا تعتمد عليه.
-   **تجاوز خاص بالمحادثة.** تتقدّم `spring.ai.openai.chat.base-url` و`spring.ai.openai.chat.api-key` على الخصائص المشتركة لنموذج المحادثة. استخدمهما إن كان على نماذج Spring AI الأخرى من OpenAI (مثل التضمينات) أن تبقى على OpenAI.
-   **إعادة المحاولة.** القيمة الافتراضية لـ `spring.ai.retry.max-attempts` هي 10 مع تراجع أُسّي (exponential backoff). وعلى مفتاح الدفع حسب الاستخدام قد يستنزف ذلك الحد الدقيقي سريعًا؛ ففكّر في خفضها.

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

| الاستخدام | `spring.ai.openai.chat.model` |
| --- | --- |
| استدعاء الأدوات والمخرجات المنظَّمة | `broadnet/glm-5.3` |
| الصور أو النص العربي | `broadnet/qwen3.8-27b` |
| المستندات الطويلة، خطة بسعر ثابت | `broadnet/deepseek-v4.1-flash` |
| الرصيد المبدئي المجاني | `broadnet/gemma-4-26b-a4b` |

[أسعار كل النماذج](https://broadrouter.com/ar/pricing/).

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

-   **401.** المفتاح خاطئ أو منتهي الصلاحية أو استنفد رصيده، أو أن `BROADNET_API_KEY` غير مضبوط لـ JVM.
-   **404.** الرابط الأساسي ينقصه `/v1`، أو أن معرّف النموذج خاطئ. النماذج المدفوعة تحتاج إلى شحن الرصيد؛ والرصيد البالغ $5 يغطي `broadnet/gemma-4-26b-a4b` ونموذجَي Transcribe.
-   **`content()` فارغ.** استهلك الاستدلال ميزانية المخرجات. ارفع `max-tokens`. راجع [لماذا تعود الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **400 مع ضبط حدَّي الرموز كليهما.** احذف `max-completion-tokens`.
-   **429.** يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ. راجع [الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).

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

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

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

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

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

[الانتظار الأُسّي (Exponential backoff)](https://broadrouter.com/ar/glossary/exponential-backoff/)

الانتظار الأُسّي (exponential backoff) استراتيجية لإعادة المحاولة ينتظر فيها العميل مدة أطول بعد كل محاولة فاشلة، وعادةً يضاعف التأخير حتى حد أقصى، قبل أن يحاول مجددًا. وإضافة تذبذب عشوائي (jitter) إلى كل انتظار توزّع محاولات العملاء الكثيرين كي لا تصل إلى الخادم في اللحظة نفسها.

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

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

[التضمينات (Embeddings)](https://broadrouter.com/ar/glossary/embeddings/)

التضمينات (embeddings) قوائم من الأعداد العشرية (متجهات) يُنتجها نموذج لتمثيل قطعة نص أو صورة أو أي مدخل آخر. وتحصل المدخلات المتشابهة في المعنى على متجهات متقاربة، فيمكن استخدام المسافة بين المتجهات لترتيب نتائج البحث أو تجميع المستندات أو إيجاد العناصر المرتبطة.

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

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

[الرمز (التوكن، 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، إلى أن يعود الاستخدام تحت الحد.

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

### هل يجب أن تتضمن قيمة spring.ai.openai.base-url المسار /v1؟

نعم. ففي Spring AI 2.x تُمرَّر القيمة كما هي إلى عميل openai-java، وقيمته الافتراضية هي https://api.openai.com/v1. استخدم https://inference.broadnet.ai/v1.

### هل أستخدم max-tokens أم max-completion-tokens مع BroadNet؟

استخدم max-tokens. يقول توثيق Spring AI إن الخيارين لا يجتمعان. ويصف المرجع التقني لـ BroadNet API الحقل max\_tokens، والاستدلال يُحتسب ضمنه، فاسمح بـ 1,000 رمز أو أكثر.

### هل يعمل استدعاء الأدوات في Spring AI مع BroadNet؟

استخدم GLM 5.3 أو Qwen3.8 27B، فهما مُدرجان مع الأدوات لدى BroadNet. ولا يُدرج توثيق BroadNet استدعاء الأدوات لنموذج DeepSeek V4.1 Flash.

### هل يمكنني إبقاء OpenAI للتضمينات واستخدام BroadNet للمحادثة؟

نعم. فالخاصيتان spring.ai.openai.chat.base-url وspring.ai.openai.chat.api-key تتقدّمان على الخصائص المشتركة لنموذج المحادثة وحده. ولا يُدرج المرجع التقني لـ BroadNet API نقطة نهاية للتضمينات (embeddings).

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

-   [استدعاء BroadNet Inference من Go بحزمة openai-go](https://broadrouter.com/ar/guides/openai-go-sdk/)
-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/)
-   [لماذا يعيد نموذج الاستدلال إجابة فارغة؟](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/)
-   [رموز أخطاء BroadNet Inference ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/)
-   [كل الأدوات التي تعمل مع 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-spring-ai-openai-base-url&utm_content=page-cta) ·

**المصادر**

-   [مرجع Spring AI، صفحة OpenAI Chat (الإصدار 2.0.2) (رُوجع في 2026-11-15)](https://docs.spring.io/spring-ai/reference/api/chat/openai-chat.html)
-   [الشيفرة المصدرية لـ Spring AI عند v2.0.2، الدالة OpenAiSetup.calculateBaseUrl (رُوجعت في 2026-11-16)](https://github.com/spring-projects/spring-ai/blob/v2.0.2/models/spring-ai-openai/src/main/java/org/springframework/ai/openai/setup/OpenAiSetup.java)
-   [المرجع التقني لـ BroadNet Inference API (رُوجع في 2026-11-15) (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-spring-ai-openai-base-url&utm_content=sources)
