freellmapi: واجهة API موحدة لنماذج LLM المجانية، المخاطر والاستخدام

freellmapi: موجّه متوافق مع OpenAI يجمع عروض النماذج اللغوية المجانية، التثبيت وفق README، وشروط المزودين والحصص والخصوصية.
freellmapi LLM gratuits API unifiée : risques et usage

freellmapi: المستودع tashfeenahmed/freellmapi موجّه (router) مستضاف ذاتيًا يعرض نقطة وصول واحدة متوافقة مع OpenAI (/v1) أمام العروض المجانية لعشرات مزودي النماذج. كان يعرض نحو 39 200 نجمة و5 300 تفرّع (fork) في منتصف أكتوبر 2026، بترخيص MIT.

الفكرة جذابة: عميل واحد، وحصص مجانية متعددة تُجمع معًا، وتحويل تلقائي عند الخطأ 429. لكنها تطرح على فريق التشغيل ثلاثة أسئلة جدية: شروط استخدام كل مزود، وخصوصية ما يُرسَل، وموثوقية خدمة بلا ضمان. يستعرضها هذا المقال استنادًا إلى README ووثائق المشروع.

المعلومات مأخوذة من README ووثائق المستودع. لم تثبّت span.observer المشروع freellmapi ولم تختبره: اللقطات أدناه صور نشرها المشروع في مستودعه. أما الأرقام الدعائية في README (حجم الرموز المميّزة وعدد المزودين) فتُنقل بوصفها ادعاءات من المشروع، غير متحقَّق منها.

freellmapi: ما يقوله المستودع

  • المؤلف والترخيص: مستودع المستخدم tashfeenahmed على GitHub، بترخيص MIT (حقوق النشر 2026 في ملف LICENSE).
  • طريقة العمل: تضيف مفاتيح API المجانية الخاصة بك؛ فيختار الموجّه نموذجًا لكل طلب، وينتقل إلى التالي عند الخطأ 429 أو 5xx، ويتتبع الاستخدام لكل مفتاح (الطلبات والرموز في الدقيقة وفي اليوم) ليبقى تحت الحدود القصوى.
  • أرقام يعلنها المشروع: «34 مزودًا مجانيًا» و«635 نقطة وصول»؛ وتذكر صفحة GitHub كذلك «7.4 مليار رمز في الشهر». هذه مجاميع لحصص مجانية مدرجة، لا سعة مضمونة ولا مقيسة.
  • واجهات API (بحسب README): المحادثة والاستجابات والتضمينات (embeddings) والصور والصوت، إضافة إلى Messages API من Anthropic، ما يتيح ربط Claude Code بالموجّه.
  • إطار الاستخدام: ينتهي وصف المستودع بعبارة «Personal experimentation only»، ويوضح README: «personal experimentation and learning, not production».
لوحة FreeLLMAPI، صفحة Models: ميزانية الرموز الشهرية لكل نموذج، واستراتيجية التوجيه Balanced، وشريط Router pressure، وترتيب النماذج مع درجات الموثوقية والسرعة والذكاء
Source : github.com

تُظهر صفحة Models من لوحة المعلومات (dashboard)، المنشورة في المستودع، ميزانية الرموز الشهرية موزعة على النماذج، واستراتيجية التوجيه (Manual وBalanced وSmartest وFastest وMost reliable وCustom)، وترتيبًا بدرجات للموثوقية والسرعة والذكاء تُحدَّث بحسب حركة الطلبات.

تثبيت freellmapi وفق README

الخطوة 1: سكربت التثبيت (يتطلب Docker)

curl -fsSL https://freellmapi.co/install.sh | bash

بحسب README، ينشئ السكربت المجلد ~/freellmapi ويولّد مفتاح تشفير وينزّل الصورة ويشغّل الحاوية. ويذكّر README بإمكان قراءة السكربت قبل تنفيذه: افعل ذلك، خصوصًا أن الأمر ينزّل سكربتًا بعيدًا. إعادة تشغيل السكربت تحافظ على ملف .env والمفتاح.

الخطوة 2: إضافة المفاتيح والحصول على المفتاح الموحد

افتح http://localhost:3001، وأضف مفاتيح المزودين في صفحة Keys، ورتّب سلسلة التحويل البديل، ثم انسخ المفتاح الموحد الظاهر أعلى الصفحة: هو ما ستستخدمه تطبيقاتك.

الخطوة 3: توجيه عميل متوافق مع OpenAI

from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:3001/v1",
    api_key="freellmapi-your-unified-key",
)
resp = client.chat.completions.create(
    model="auto",
    messages=[{"role": "user", "content": "Summarise the fall of Rome in one sentence."}],
)
print(resp.choices[0].message.content)

يأخذ هذا المثال مثال README (مختصرًا قليلًا). القيمة model="auto" تترك الاختيار للموجّه. وبحسب وثائق API، تحمل كل استجابة ترويسة X-Routed-Via: <plateforme>/<modèle> تبيّن أي مزود أجاب فعليًا: لقراءتها، جرّب curl -i.

متغيرات أخرى

يقترح README أيضًا تطبيق سطح مكتب (.dmg لنظام macOS ومثبّتًا .exe لنظام Windows، في Releases)، ونشرًا عبر Docker Compose، ووضعًا للتطوير. ويصف إعدادًا تلقائيًا لعدد كبير من الوكلاء، مثل npx freellmapi setup-claude --url http://localhost:3001 --api-key <unified-key>.

تحت الغطاء: التوجيه والحصص والسجلات

يصف المشروع موجّهًا يختار النموذج ذا الأولوية الذي يملك مفتاحًا سليمًا وتحت جميع حدوده، ويفك تشفير المفتاح في الذاكرة، ويستدعي المزود، وعند الخطأ 429 أو 5xx يوقف المفتاح مؤقتًا قبل الانتقال إلى النموذج التالي.

مخطط عمل FreeLLMAPI المنشور في المستودع: تطبيق عميل يستدعي /v1، والموجّه يرتب النماذج، ويتخطى مزودًا أعاد الخطأ 429، ويجيب عبر مزود آخر
Source : github.com

يوضح المخطط هذا المسار: مزود أول يعيد 429 فيُستبعد، ويجيب مزود ثان. ويذكر README أن مفاتيح المزودين تُشفَّر بخوارزمية AES-256-GCM في SQLite وتُفك في الذاكرة عند كل طلب.

مراقبة موجّه لنماذج LLM مجانية

تصف وثائق بنية المشروع جزءًا خاصًا بقابلية الملاحظة (observability): عارض لسجلات الخادم في لوحة المعلومات، وسجلات تُحفظ في الذاكرة (1 000 إدخال) وفي قاعدة البيانات للتحذيرات والأخطاء، وصفحة Analytics (حجم الطلبات ومعدل النجاح والرموز وزمن الاستجابة p50 وp95 والمهلة قبل أول رمز) على نوافذ من 24 ساعة إلى 90 يومًا. لم أجد أي إشارة إلى OpenTelemetry في README ولا في الوثائق.

لوحة FreeLLMAPI، صفحة Analytics على سبعة أيام: الطلبات ومعدل النجاح والرموز الداخلة والخارجة ومتوسط زمن الاستجابة وp95 ومنحنيات الطلبات والرموز عبر الزمن
Source : github.com
  • السجلات: مع Docker، الأمر docker compose logs -f freellmapi (الأسئلة الشائعة في README)؛ وفي تطبيق سطح المكتب، الملف freeapi.log في مجلد البيانات.
  • من جهة العميل: إن أردت تتبعات في الواجهة الخلفية الخاصة بك، فزوّد بالقياس البرمجي (instrumentation) التطبيق الذي يستدعي الموجّه، مثلًا بالطرق الواردة في قابلية ملاحظة LLM مع OpenLLMetry وLangfuse، وسجّل الترويسة X-Routed-Via سمةً.
  • التكاليف: الاستخدام مجاني ما دامت الحصص كافية، لكن الوقت الضائع في الأخطاء والتحويل البديل له كلفة. راجع تتبع كلفة وكيل ذكاء اصطناعي.

شروط الاستخدام والحصص والخصوصية

هذه هي النقطة الأهم. يذكّر README بأن علاقتك بكل مزود تبقى محكومة بالشروط التي قبلتها عند إنشاء الحساب، وأن هذه الشروط تنطبق أيضًا حين تمر الحركة عبر هذا المشروع: أنت المسؤول عن الالتزام بها.

  • تحليل المشروع، لا تحليلنا. تتضمن الوثائق جدول مراجعة لشروط الاستخدام مؤرخًا في مايو 2026، مزودًا بمزود (مثلًا «احتراز» لـ Google Gemini وNVIDIA NIM، و«يُتجنب» لـ Cohere). هذا رأي المشروع، بلا قيمة قانونية، وقد مضت عليه أشهر. أعد قراءة الشروط السارية لكل مزود قبل أي استخدام.
  • الحصص. تحذّر وثائق المشروع من أن العروض المجانية قد تُقلَّص أو تُسحب دون إشعار؛ وأفضل النماذج لها أدنى الحدود اليومية، وتنخفض الجودة الفعلية في آخر اليوم حتى إعادة الضبط عند منتصف الليل بالتوقيت العالمي (UTC). المبالغ التي يذكرها المشروع هي ما يدرجه المشروع، لا التزامات من المزودين.
  • الخصوصية. يخرج كل طلب من جهازك إلى المزود الذي يختاره الموجّه، وهذا الاختيار يتغير بحسب الحصص والأخطاء. لذا لا تتحكم في أي مزود يرى أي prompt. لا ترسل بيانات شخصية ولا شيفرة سرية، وتحقق لكل عرض مجاني مما إذا كان يجوز استخدام التبادلات لتحسين النماذج.
  • الاستدعاءات الصادرة من الموجّه. يذكر README أن الموجّه ينزّل مرتين في اليوم فهرسًا موقّعًا من freellmapi.co، وأن خادم الفهرس هذا لا يرى prompts ولا مفاتيحك، بحسب المشروع. وتتلقى التثبيتات المجانية لقطة شهرية بتأخير 30 يومًا؛ ويبيع المشروع أيضًا عرضًا مدفوعًا للفهرس المباشر.

كيف تتحقق من أن كل شيء يعمل

  • طلب curl -i إلى /v1/chat/completions بالمفتاح الموحد يعيد استجابة وترويسة X-Routed-Via.
  • تبيّن صفحة Keys حالة كل مفتاح (سليم أو في خطأ) وتاريخ آخر فحص.
  • تسجل صفحة Analytics طلب الاختبار؛ وتُظهر السجلات التحويل البديل حين تعطّل مفتاحًا.

الحدود والنقاط المفتوحة

  • لا إنتاج. المشروع نفسه يقول ذلك: لا SLA، وزمن استجابة متغير، وجودة تتراجع على مدار اليوم. للاستخدام الحقيقي، انتقل إلى API مدفوعة بعقد؛ راجع اختيار LLM وفق معايير التشغيل.
  • استخدام محلي لمستخدم واحد. تشير وثائق المشروع إلى عدم وجود مصادقة متعددة المستخدمين: لا تعرضه على الإنترنت.
  • منطقة رمادية تعاقدية. قد يخالف تجميع عروض مجانية خلف وكيل (proxy) شروط بعض المزودين، حتى في الاستخدام الشخصي.
  • مشروع شائع جدًا وحديث. كثرة النجوم لا تعني تدقيقًا: اقرأ الشيفرة قبل أن تأتمنه على مفاتيح API.
  • الأرقام. النجوم والتفرعات مسجّلة في منتصف أكتوبر 2026؛ ومجاميع الرموز هي ما في README.

أفضل الممارسات

  • اقصره على التجريب، ببيانات عامة أو وهمية.
  • اقرأ سكربت التثبيت قبل تنفيذه، وأبقِ الموجّه على localhost أو على شبكة خاصة.
  • أنشئ لدى كل مزود مفاتيح مخصصة، قابلة للإلغاء، بلا صلاحيات فوترة.
  • عطّل المزودين الذين لا تناسب شروطهم استخدامك، من صفحة Keys.
  • زوّد العميل بالقياس البرمجي، واحتفظ بحل بديل مدفوع لكل ما يهمّ.
  • للاستدلال (inference) الذي تتحكم فيه من البداية إلى النهاية، راجع Ollama محليًا أو vLLM في الإنتاج.

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

هل freellmapi مجاني فعلًا؟

الشيفرة بترخيص MIT وتستخدم مفاتيحك المجانية الخاصة. ويوجد عرض مدفوع للفهرس المباشر، ويمكن للمزودين تعديل عروضهم المجانية أو سحبها في أي وقت.

هل يمكنني استخدامه في الإنتاج؟

يحذّر المشروع من ذلك صراحةً: «personal experimentation and learning, not production». استخدم API مدفوعة بعقد لأي خدمة حقيقية.

هل prompts الخاصة بي سرية؟

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

الخلاصة

freellmapi فكرة عملية لبناء النماذج الأولية بلا فاتورة، مع لوحة معلومات وسجلات متقنة. لكنه يبقى أداة تجريب: شروط استخدام يجب التحقق منها مزودًا بمزود، وحصص متغيرة، وخصوصية غير مضبوطة. أبقِه بعيدًا عن البيانات الحساسة وعن الإنتاج.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا للمشاريع المذكورة. العلامات التجارية المذكورة ملك لأصحابها. الأدوات تتطور بسرعة، لذا تحقق دائمًا من الأوامر والخيارات في الوثائق الرسمية (github.com/tashfeenahmed/freellmapi). لا يشكّل هذا المقال استشارة قانونية.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
ppt-master générer PowerPoint agent IA : guide et limites

توليد عروض PowerPoint بوكيل ذكاء اصطناعي مع ppt-master

Next Post
Knowledge work plugins Claude Cowork : installer et contrôler

Knowledge work plugins لـ Claude Cowork: التثبيت والتحكم

Related Posts