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):
<dependency>
<groupId>org.springframework.ai</groupId>
<artifactId>spring-ai-starter-model-openai</artifactId>
</dependency>
الإعداد
الملف application.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
export BROADNET_API_KEY='your-broadnet-key'
أبقِ /v1 في الرابط. ففي Spring AI 2.x تذهب القيمة إلى عميل openai-java دون تغيير (إذ تعيدها OpenAiSetup.calculateBaseUrl كما هي)، وذلك العميل يضيف /chat/completions. والقيمة الافتراضية التي تستبدلها هي https://api.openai.com/v1.
الاستدعاء والاختبار
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 |
حل المشكلات
- 401. المفتاح خاطئ أو منتهي الصلاحية أو استنفد رصيده، أو أن
BROADNET_API_KEYغير مضبوط لـ JVM. - 404. الرابط الأساسي ينقصه
/v1، أو أن معرّف النموذج خاطئ. النماذج المدفوعة تحتاج إلى شحن الرصيد؛ والرصيد البالغ $5 يغطيbroadnet/gemma-4-26b-a4bونموذجَي Transcribe. content()فارغ. استهلك الاستدلال ميزانية المخرجات. ارفعmax-tokens. راجع لماذا تعود الإجابات فارغة.- 400 مع ضبط حدَّي الرموز كليهما. احذف
max-completion-tokens. - 429. يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ. راجع الأخطاء وإعادة المحاولة.
