دليل Gemma 4 31B: القدرات، حالات الاستخدام والوصول عبر API

غالبًا ما يؤدي بناء تطبيقات متعددة اللغات تخدم قواعد مستخدمين متنوعة إلى دفع المطورين vào متاهة من تنسيقات API المتضاربة، وSDKs الخاصة بمزودين معينين، ولوحات فوترة مجزأة. تضيف كل لغة أو منطقة جديدة تعقيدًا، خاصة عندما تحتاج إلى دعم عالي الجودة للغة العربية بجانب القدرات الرئيسية باللغة الإنجليزية. بدلاً من الحفاظ على تكاملات منفصلة لكل مزود نموذج، تحتاج فرق الهندسة إلى بوابة واحدة توحد الوصول، وتوحد الفوترة، وتحافظ على حرية تبديل النماذج دون إعادة كتابة كود العميل.

تلبي بوابة LLM Resayil Portal هذه الحاجة. مستضافة في الولايات المتحدة الأمريكية، البوابة هي واجهة برمجة تطبيقات LLM متوافقة مع OpenAI و Anthropic مع دعم للغة العربية. تعرض البوابة 33 نموذجًا نشطًا من خلال عنوان URL أساسي موحد، مما يمنح المطورين القدرة على توجيه حركة المرور عبر فئات الدردشة، والبرمجة، والتفكير، والرؤية باستخدام أدوات مألوفة. تدعم المنصة البث المباشر (streaming)، واستدعاء الدوال (function calling)، والرؤية الحاسوبية (vision)، ونماذج التفكير (thinking models)، واستخدام الأدوات (tool use)، وأعباء العمل متعددة اللغات، وكل ذلك مدعوم بنظام اعتمادات حسب الاستخدام (pay-per-use) يتم فوترة بالدولار الأمريكي (USD).

من بين النماذج الـ 33 النشطة المتاحة اليوم نموذج Gemma 4 31B (gemma4:31b)، وهو نموذج من فئة الدردشة يناسب الذكاء الاصطناعي conversational العام، والمساعدة في البرمجة، وإنشاء المحتوى متعدد اللغات. نظرًا لأن Resayil تدعم كلًا من OpenAI SDK و Anthropic SDK، يمكنك دمج gemma4:31b في خط أنابيب Python، أو خدمة مصغرة JavaScript، أو سير عمل n8n بدون كود دون تعلم تنسيق طلب جديد. تمتد التكاملات أيضًا إلى LangChain و LiteLLM للفرق التي تبني أنظمة ذكاء اصطناعي مركبة.

يصطحبك هذا الدليل عبر الدورة الكاملة لاستخدام Gemma 4 31B على Resayil. ستتعلم كيفية التحقق من أن النموذج مباشر عبر نقطة النهاية /v1/models، وكيفية إرسال طلبات البث المباشر عبر SDKs المتوافقة، وكيف يعمل هيكل الفوترة حسب الاستخدام مع Stripe و PayPal.

الوصول الموحد للواجهة البرمجية مقابل إدارة مزودين متعددين

عندما تحتاج إلى تشغيل نماذج مثل Gemma 4 31B بجانب نماذج LLM متخصصة أخرى، تصبح إدارة علاقات المزودين المباشرين مكلفة من حيث وقت الهندسة. توحد بوابة LLM Resayil Portal الوصول حتى تتمكن من الحفاظ على طبقة تكامل واحدة.

| القدرة | بوابة LLM Resayil Portal | واجهة OpenAI API المباشرة | |---|---|---| | توافق API | متوافق مع OpenAI و Anthropic | تنسيق OpenAI فقط | | كتالوج النماذج | 33 نموذجًا نشطًا | عائلة نماذج OpenAI فقط | | العربية ومتعدد اللغات | دعم اللغة العربية ومتعدد اللغات | قدرات متعددة اللغات عامة | | موقع الاستضافة | الولايات المتحدة الأمريكية | الولايات المتحدة الأمريكية | | عملة الفوترة | USD | USD | | طرق الدفع | Stripe, PayPal | فواتير وبطاقات خاصة | | نموذج التسعير | اعتمادات حسب الاستخدام (Pay-per-use) | خطط استخدام وطبقات اشتراك | | دعم SDK والتكامل | OpenAI SDK, Anthropic SDK, Python, JavaScript, cURL, LangChain, LiteLLM, n8n | OpenAI SDK, Python, JavaScript, cURL | | البث المباشر (Streaming) | مدعوم | مدعوم | | استدعاء الدوال (Function Calling) | مدعوم | مدعوم | | الرؤية (Vision) | مدعوم | متاح في نماذج GPT محددة | | نماذج التفكير (Thinking Models) | مدعوم | متاح عبر سلسلة o1 | | استخدام الأدوات (Tool Use) | مدعوم | مدعوم |

تقدم بوابة LLM Resayil Portal واجهة موحدة حيث تتوفر ميزات مثل البث المباشر، واستدعاء الدوال، والرؤية، ونماذج التفكير، واستخدام الأدوات عبر الكتالوج. نظرًا لأن المنصة متوافقة مع OpenAI ومتوافقة مع Anthropic، يمكنك التبديل بين gemma4:31b ونماذج أخرى دون إعادة كتابة منطق العميل. يجعل دعم اللغة العربية وميزات اللغات المتعددة الأوسع البوابة ذات قيمة خاصة للبنائين الذين يخدمون أسواق MENA أو قواعد مستخدمين مختلطة اللغات. يعمل كل شيء على بنية تحتية مستضافة في الولايات المتحدة الأمريكية، مع التعامل مع الفوترة بـ USD من خلال مزودي دفع موثوقين.

على النقيض من ذلك، فإن العمل مباشرة مع واجهة OpenAI API يحدك من النظام البيئي للنماذج الخاص بـ OpenAI. بينما تحصل على وصول من الطرف الأول إلى متغيرات GPT وطرح الميزات الأصلية، يجب عليك الحفاظ على تكاملات منفصلة لنماذج Anthropic أو المزودين الآخرين. عادةً ما تتم إدارة الفوترة من خلال لوحة تحكم OpenAI الأصلية، ولا تتلقى توافق Anthropic SDK من نفس نقطة النهاية.

بالنسبة للمطورين الذين يبنون تطبيقات متعددة اللغات تحتاج إلى وصول موحد للواجهة البرمجية لمزودي LLM متعددين، تفوز LLM Resayil من خلال القضاء على انتشار التكامل. تحصل على مفتاح واحد، وعنوان URL أساسي واحد، ووصول فوري إلى 33 نموذجًا نشطًا بما في ذلك Gemma 4 31B. تشمل الفوائد الملموسة اعتمادات حسب الاستخدام بدلاً من الاشتراكات الجامدة، والتوافق مع كل من OpenAI و Anthropic SDKs، ودعم سير العمل المبنية في LangChain أو LiteLLM أو n8n.

فيما يلي مثال Python الحد الأدنى باستخدام OpenAI SDK و slug الكتالوج المعتمد:

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://llm.resayil.io/v1",
    api_key=os.environ.get("RESAYIL_API_KEY")
)

response = client.chat.completions.create(
    model="gemma4:31b",
    messages=[{"role": "user", "content": "اشرح استدعاء الدوال باللغة العربية."}],
    stream=True
)

for chunk in response:
    print(chunk.choices[0].delta.content or "", end="")

التحقق من توفر النموذج عبر واجهة Resayil API

قبل نشر مطالبة إنتاجية، تأكد من أن gemma4:31b موجود في الكتالوج الحالي. تعرض بوابة LLM Resayil Portal نقطة النهاية /v1/models لهذا الغرض بالضبط. يؤدي استدعاؤها إلى إرجاع قائمة بـ 33 نموذجًا نشطًا، مما يسمح لك بالتحقق من slugs والتوفر دون تخمين.

يبدو التحقق البسيط باستخدام cURL هكذا:

curl -s https://llm.resayil.io/v1/models \
  -H "Authorization: Bearer $RESAYIL_API_KEY"

بعد تنفيذ الطلب، افحص المصفوفة المعادة للبحث عن إدخال يحتوي على slug gemma4:31b. نظرًا لأن API متوافقة مع OpenAI، يتبع هيكل الحمولة اصطلاحات مألوفة من نظام OpenAI البيئي، مما يجعل التحليل مباشرًا في Python أو JavaScript.

للحصول على فحص مستهدف، استعلم عن نقطة النهاية الخاصة بالنموذج. تدعم البوابة كلًا من /v1/models/{id} و /v1/models/{modelId}، لذا فإن استرجاع تفاصيل Gemma 4 31B مباشر مثل:

curl -s https://llm.resayil.io/v1/models/gemma4:31b \
  -H "Authorization: Bearer $RESAYIL_API_KEY"

يمنع أتمتة هذه الخطوة داخل خط أنابيب CI/CD أخطاء النشر عند تدوير النماذج أو تحديثها. إذا كان تطبيقك يعتمد على قدرات الدردشة في Gemma 4 31B، فإن فحص الحالة المسبق للنشر مقابل /v1/health يليه فحص الكتالوج مقابل /v1/models يضمن أن البيئة جاهزة. يمكنك تخزين استجابة الكتالوج مؤقتًا لبضع دقائق لتجنب المكالمات الزائدة عن الحاجة، ثم التحقق من صحة سلاسل النموذج المحددة من المستخدم مقابل القائمة المخزنة مؤقتًا. هذا النمط مفيد بشكل خاص عندما تعرض خيارات نماذج متعددة في واجهة مستخدم وتحتاج إلى تأكيد أن slug المطلوب موجود بين النماذج الـ 33 النشطة قبل إنفاق الرموز.

نظرًا لأن البوابة تحافظ على توافق Anthropic بجانب توافق OpenAI، فإن منطق التحقق نفسه يعمل بغض النظر عن SDK الذي تتبناه. يمكن للمطورين الذين يستخدمون LangChain أو LiteLLM توجيه سجل النموذج الخاص بهم إلى https://llm.resayil.io/v1/models وتحميل slugs المتاحة ديناميكيًا مثل gemma4:31b، mistral-large-3:675b، أو gemini-3-flash-preview دون ترميز عناوين URL خاصة بالمزود.

التكامل مع SDKs المتوافقة

بمجرد تأكيد أن gemma4:31b متاح، فإن الخطوة التالية هي إصدار الطلبات. تدعم بوابة LLM Resayil Portal OpenAI SDK، و Anthropic SDK، و Python، و JavaScript، و cURL، لذا يمكنك دمج Gemma 4 31B باستخدام المكدس الذي تعرفه بالفعل.

OpenAI SDK (Python)

يعد OpenAI SDK أسرع طريقة للبدء. اضبط base_url على https://llm.resayil.io/v1 ومرر مفتاح Resayil API الخاص بك.

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://llm.resayil.io/v1",
    api_key=os.environ.get("RESAYIL_API_KEY")
)

completion = client.chat.completions.create(
    model="gemma4:31b",
    messages=[
        {"role": "system", "content": "أنت مساعد برمجة مفيد."},
        {"role": "user", "content": "اكتب دالة بايثون تعكس النص."}
    ],
    stream=True
)

for chunk in completion:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

لاحظ أن model مضبوطة على slug الكتالوج gemma4:31b. يعمل المعلمة stream=True على تمكين تسليم الرموز في الوقت الفعلي، وهو مدعوم بواسطة ميزة البث المباشر للمنصة.

Anthropic SDK (JavaScript)

إذا كان قاعدة الكود الخاصة بك تستخدم بالفعل Anthropic SDK، يمكنك إعادة توجيهها إلى نقطة النهاية المتوافقة مع Anthropic الخاصة بـ Resayil. يرسل المثال التالي طلب رسالة إلى gemma4:31b:

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  baseURL: 'https://llm.resayil.io/v1',
  apiKey: process.env.RESAYIL_API_KEY,
});

const message = await client.messages.create({
  model: 'gemma4:31b',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'ما هي أفضل ممارسات تصميم واجهات برمجة التطبيقات متعددة اللغات؟' }],
});

console.log(message.content);

نظرًا لأن البوابة متوافقة مع Anthropic، فإن مصافحة SDK، وعد الرسائل عبر /v1/messages/count_tokens، وإنشاء الرسائل عبر /v1/messages تعمل جميعها مقابل نفس عنوان URL الأساسي.

cURL و JavaScript Fetch

بالنسبة للنصوص الخفيفة أو وظائف الحافة، تعمل طلبات HTTP الخام بشكل متطابق:

curl https://llm.resayil.io/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $RESAYIL_API_KEY" \
  -d '{
    "model": "gemma4:31b",
    "messages": [{"role": "user", "content": "مرحبا"}],
    "stream": true
  }'

في بيئات المتصفح أو Node.js باستخدام JavaScript:

const res = await fetch("https://llm.resayil.io/v1/chat/completions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${process.env.RESAYIL_API_KEY}`
  },
  body: JSON.stringify({
    model: "gemma4:31b",
    messages: [{ role: "user", content: "اشرح الفوترة حسب الاستخدام." }],
    stream: true
  })
});

الميزات المتقدمة

تشمل الميزات المعتمدة للمنصة استدعاء الدوال، واستخدام الأدوات، ودعم نماذج التفكير. عند استخدام gemma4:31b، يمكنك إرفاق تعريفات الأدوات بمصفوفة tools في حمولة إكمال الدردشة الخاصة بك. الرؤية هي أيضًا ميزة منصة؛ بينما يصنف gemma4:31b كنموذج دردشة، فإن هيكل API نفسه يسمح لك باستدعاء نماذج قادرة على الرؤية مثل glm-5.1 دون تغيير أنماط التكامل.

لأتمتة سير العمل، تندمج البوابة مع n8n. للتنسيق في تطبيقات Python، يمكن لكل من LangChain و LiteLLM استخدام https://llm.resayil.io/v1 كعنوان URL للمزود، passing gemma4:31b كاسم النموذج. تعني هذه المرونة أنك لست مقيدًا أبدًا بـ SDK واحد للوصول إلى كتالوج الـ 33 نموذجًا.

هيكل التسعير والفوترة

تستخدم بوابة LLM Resayil Portal نظام اعتمادات حسب الاستخدام (pay-per-use). يستهلك كل طلب إلى gemma4:31b اعتمادات بناءً على استخدام الرموز، وتضيف الأموال فقط عند الحاجة. تتم جميع عمليات الفوترة وإعادة الشحن بـ USD، مما يبقي تحويل العملة بسيطًا للفرق العالمية.

يمكنك مراجعة الأسعار الحالية برمجيًا من خلال نقطة النهاية /v1/pricing:

curl -s https://llm.resayil.io/v1/pricing \
  -H "Authorization: Bearer $RESAYIL_API_KEY"

عندما ينخفض رصيدك، توفر نقطة النهاية /v1/pricing/topups مسارًا برمجيًا لإضافة الاعتمادات. للإدارة اليدوية، تقبل لوحة الدفع المدفوعات عبر Stripe و PayPal، وهما طريقتا الدفع المعتمدتان المدعومتان من المنصة.

يستبدل هذا النموذج الاشتراكات الشهرية الجامدة بالتحكم الدقيق. يمكن للمطورين الذين يقومون بالنماذج الأولية مع gemma4:31b البدء بشحن صغير، وزيادة الاستخدام مع نمو حركة مرور المستخدم، وعدم الدفع أبدًا مقابل السعة الخاملة. نظرًا لأن الكتالوج الكامل المكون من 33 نموذجًا نشطًا يشارك نفس_pool_ الاعتمادات، يمكنك إجراء اختبار A/B لـ gemma4:31b مقابل mistral-large-3:675b أو ministral-3:14b دون إدارة فواتير مزود منفصلة.

تضمن الاستضافة في الولايات المتحدة الأمريكية زمن انتقال متسق لمستخدمي أمريكا الشمالية والعالميين، بينما elimina التسعير الموحد بـ USD تعقيد المحاسبة متعددة العملات. سواء كنت تبني روبوتات دردشة، أو مساعدي برمجة، أو خطوط أنابيب محتوى متعددة اللغات، فإن هيكل حسب الاستخدام يوائم التكاليف مباشرة مع حركة مرور الإنتاج.

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

س: كيف أتحقق من توفر نموذج معين؟ ج: استخدم نقطة نهاية API /v1/models لعرض قائمة النماذج الـ 33 النشطة. يمكنك مسح الكتالوج المعاد للبحث عن slug gemma4:31b أو الاستعلام عن /v1/models/gemma4:31b مباشرة لتأكيد أن النموذج نشط.

س: ما هي طرق الدفع التي يقبلها Resayil؟ ج: تتم معالجة المدفوعات عبر Stripe و PayPal. هذه هي طرق الدفع المعتمدة المتاحة على المنصة.

س: أين تستضاف البنية التحتية للـ API؟ ج: موقع الاستضافة الأساسي هو الولايات المتحدة الأمريكية. يتم خدمة جميع طلبات API إلى https://llm.resayil.io من بنية تحتية مستضافة في الولايات المتحدة الأمريكية.

س: ما هي العملة المستخدمة للفوترة؟ ج: تتم جميع عمليات الفوترة وإعادة الشحن بـ USD. تدعم المنصة USD كعملة فوترة لها.

س: هل تدعم المنصة معالجة اللغة العربية؟ ج: نعم. دعم اللغة العربية هو ميزة معتمدة لبوابة LLM Resayil Portal. تدعم المنصة أيضًا معالجة متعدد اللغات، مما يجعلها مناسبة للتطبيقات متعددة اللغات.

ابدأ البناء مع Gemma 4 31B اليوم

لديك الآن خريطة كاملة للتحقق من ودمج وفوترة Gemma 4 31B عبر بوابة LLM Resayil Portal. مع توافق OpenAI و Anthropic، و 33 نموذجًا نشطًا، واعتمادات حسب الاستخدام بـ USD، يمكنك شحن ميزات متعددة اللغات بشكل أسرع دون الحفاظ على تكاملات مزودين متعددين.

قم بزيارة https://llm.resayil.io لاستكشاف الأسعار، و التسجيل للحصول على مفتاح API، ومراجعة الوثائق لبدء بث الاستجابات من gemma4:31b في دقائق.