واجهة LLM مجانية لوكلاء الذكاء الاصطناعي
يرسل وكيل الذكاء الاصطناعي طلبات كثيرة إلى النموذج لتنفيذ مهمة واحدة. تحتاج كل خطوة إلى استدعاء الأدوات وسياق كبير. مستوى مجاني واحد يوقف الوكيل بسرعة. يجمع FreeLLMAPI 45 مستوى مجانياً من المزوّدين خلف مفتاح واحد متوافق مع OpenAI. ينتقل إلى المزوّد التالي عندما يوقف حد الاستخدام طلباً، فيستطيع الوكيل المتابعة. يغطي هذا الدليل استدعاء الأدوات، والتوجيه لكل خطوة، والجلسات الطويلة، وخادم MCP الخاص بالموجّه.
تُعرض الشيفرة وأسماء النماذج وتسميات الكتالوج المباشر باللغة الإنجليزية.
ما يحتاجه الوكيل من واجهة مجانية
| الحاجة | السبب | ما يفعله FreeLLMAPI |
|---|---|---|
| استدعاء الأدوات | يختار الوكيل الأدوات ويشغّلها | يمرّر tools بصيغة OpenAI إلى كل مزوّد. يحوّل استدعاءات الأدوات المكتوبة كنص عادي إلى tool_calls حقيقية. |
| طلبات كثيرة | قد تأخذ مهمة واحدة من 20 إلى 100 خطوة | يحسب حصة كل مفتاح وينتقل إلى المفتاح أو المزوّد التالي عند الرمز 429 |
| سياق كبير | تكبر نتائج الأدوات والسجل في كل خطوة | يوجّه إلى نماذج من سلسلتك. يمكنك إنشاء ملف تعريف للسياق الطويل. |
| سلوك ثابت | قد يربك تغيير النموذج في منتصف المهمة الوكيل | يُبقي الجلسة على نموذج واحد لمدة 30 دقيقة. يمكن تفعيل نقل السياق عند حدوث تغيير. |
| الرؤية | يجب أن تعرف أي نموذج فشل | ترويسات X-Routed-Via وX-Fallback-Trail في كل استجابة |
للمستويات المجانية حدود. يوزّع الاحتياط الحمل على مفاتيحك، لكن المجموع يبقى مجموع الحدود المجانية. أضف مفاتيح من أربعة مزوّدين أو أكثر لأعمال الوكلاء.
| النموذج | مجاني على | السياق | الحدود المجانية (أفضل عرض) | الأدوات | الرؤية |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 طلب/دقيقة 1 req/min per model | نعم | لا |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 طلب/دقيقة 40 RPM | نعم | نعم |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | نعم | نعم |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | نعم | لا |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | نعم | نعم |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 طلب/دقيقة 20 طلب/يوم 250,000 رمز/دقيقة ~3M | نعم | نعم |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | نعم | نعم |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 طلب/دقيقة 50 طلب/يوم 50 req/day account-wide (1,000 after a $10 purchase) | نعم | نعم |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 طلب/دقيقة 50 طلب/يوم Shared rate limit | نعم | لا |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 طلب/دقيقة 250 طلب/يوم 70,000 رمز/دقيقة ~6M | نعم | نعم |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 طلب/دقيقة 20 طلب/يوم 250,000 رمز/دقيقة ~3M | نعم | نعم |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | نعم | نعم |
يعرض 12 من أصل 109 نموذجًا مجانيًا مطابقًا. عرض كل النماذج.
بيانات مباشرة من كتالوج FreeLLMAPI (الإصدار 2026.11.19، تم التحقق 2026-11-19). تتغير الحدود المجانية كثيرًا. يُفحص الكتالوج كل يوم.
حلقة وكيل كاملة بلغة Python
تستخدم الحلقة أدناه حزمة OpenAI الرسمية. ترسل الأدوات، وتشغّل كل استدعاء أداة، وترسل النتيجة إلى النموذج، وتتوقف عندما يعطي النموذج إجابة نهائية. وتتوقف أيضاً بعد عدد أقصى من الخطوات.
agent.py
import json
import os
import time
import openai
from openai import OpenAI
client = OpenAI(
base_url="http://localhost:3001/v1",
api_key=os.environ["FREELLMAPI_API_KEY"], # <unified-key>
max_retries=3,
)
def get_weather(city: str) -> dict:
return {"city": city, "temp_c": 18, "sky": "cloudy"}
TOOLS = [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get the current weather for a city.",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"],
},
},
}]
FUNCTIONS = {"get_weather": get_weather}
def call_model(messages, session_id):
for attempt in range(5):
try:
return client.chat.completions.create(
model="auto:smart",
messages=messages,
tools=TOOLS,
extra_headers={"X-Session-Id": session_id},
)
except openai.RateLimitError as err:
header = err.response.headers.get("retry-after", "")
wait = int(header) if header.isdigit() else 2 ** attempt
time.sleep(min(wait, 60))
raise RuntimeError("All free providers are at their limit")
def run(task: str, session_id: str, max_steps: int = 10) -> str:
messages = [
{"role": "system", "content": "Use the tools when they help. Be brief."},
{"role": "user", "content": task},
]
for _ in range(max_steps):
msg = call_model(messages, session_id).choices[0].message
messages.append(msg)
if not msg.tool_calls:
return msg.content
for call in msg.tool_calls:
fn = FUNCTIONS.get(call.function.name)
try:
args = json.loads(call.function.arguments or "{}")
result = fn(**args) if fn else {"error": "unknown tool"}
except Exception as exc: # return tool errors to the model
result = {"error": str(exc)}
messages.append({
"role": "tool",
"tool_call_id": call.id,
"content": json.dumps(result),
})
return "Stopped: too many steps."
print(run("Should I take an umbrella in Dublin today?", session_id="task-001"))- X-Session-Id: يُبقي كل خطوات المهمة الواحدة على النموذج نفسه ما دام لديه حصة.
- Retry-After: عندما تبلغ كل المفاتيح حدها، تعيد البوابة الرمز 429 مع هذه الترويسة. تنتظر الحلقة وتحاول مرة أخرى.
- أخطاء الأدوات: ترسل الحلقة الأخطاء إلى النموذج كنتائج أدوات. عندئذ يستطيع النموذج تصحيح استدعائه.
وجّه كل خطوة إلى النموذج المناسب
خطوات الوكيل ليست متساوية. تحتاج خطوة التخطيط إلى نموذج قوي. وتحتاج خطوة استخراج حقل واحد إلى نموذج سريع. استخدم نص نموذج مختلفاً لكل نوع خطوة. لا تحتاج إلى تغيير لوحة التحكم.
| نص النموذج | يرتّب النماذج حسب | الاستخدام مع الوكيل |
|---|---|---|
auto:smart | الذكاء | التخطيط، واختيار الأدوات، والإجابات النهائية |
auto:fast | السرعة المقاسة وزمن الاستجابة الأول | الاستخراج، والتصنيف، والملخصات القصيرة لمخرجات الأدوات |
auto:reliable | نسبة النجاح الأخيرة | الوكلاء المجدولون الذين يجب أن ينتهوا |
auto:balanced | الموثوقية أولاً، ثم السرعة والذكاء | الإعداد العام الافتراضي |
auto:<profile> | سلسلة الاحتياط المسماة لديك | سلسلة فيها نماذج تدعم استدعاء الأدوات فقط |
تصنّف استراتيجيات auto:* كل نموذج مفعّل، وتتجاهل ترتيب سلسلتك. ما زال الطلب الذي يحتوي على أدوات يحتاج إلى نموذج يدعم استدعاء الأدوات. إذا كانت بعض النماذج المفعّلة لا تدعم الأدوات جيداً، فأنشئ ملف تعريف يضم نماذج تدعم استدعاء الأدوات فقط. ثم استخدم auto:<profile> لخطوات الأدوات. يعيد اسم الملف غير المعروف الخطأ 400.
تنقل الترويسة X-FreeLLM-Task-Type: code وزن التوجيه من السرعة إلى الذكاء لطلب واحد. وهي تفضيل مرن. لا تغيّر فحوص القدرات ولا سلسلة الاحتياط.
الجلسات الطويلة وتغيير النماذج
أثناء مهمة طويلة، قد يبلغ النموذج حده اليومي. عندئذ ينتقل الموجّه إلى نموذج آخر. يحصل النموذج الجديد على سجل الرسائل كاملاً، لكنه لا يعرف أن نموذجاً آخر نفّذ الخطوات السابقة.
فعّل نقل السياق لإضافة رسالة نظام قصيرة واحدة عند تغيير النموذج. تخبر الرسالة النموذج الجديد بمتابعة المهمة والاحتفاظ بنتائج الأدوات السابقة.
ملف .env الخاص بـ FreeLLMAPI
FREELLMAPI_CONTEXT_HANDOFF=on_model_switch- تُضاف رسالة النقل فقط عندما يتغير النموذج المختار لجلسة.
- تُحفظ الجلسات في الذاكرة لمدة 3 ساعات. لا يُكتب شيء على القرص.
- مفتاح الجلسة هو الترويسة
X-Session-Id. بدون هذه الترويسة، يكون المفتاح تجزئة (hash) لأول رسالة من المستخدم.
استخدم الموجّه كخادم MCP
FreeLLMAPI هو أيضاً خادم MCP على /mcp. يستطيع الوكيل الذي يتحدث MCP أن يرسل مهمة نصية إلى نموذج من FreeLLMAPI. ويستطيع أيضاً قراءة حالة البوابة أثناء الجلسة: النماذج المتاحة ومعاملاتها، وصحة المزوّدين، وإحصاءات الاستخدام والتخزين المؤقت، واستراتيجية التوجيه.
خاصية MCP مغلقة في التثبيتات الجديدة. فعّلها من لوحة التحكم في صفحة Keys، ضمن Agent compatibility. وهي مغلقة، يعيد /mcp الرمز 403.
أضف خادم MCP إلى Claude Code
claude mcp add --transport http freellmapi http://localhost:3001/mcp \
--header "Authorization: Bearer <unified-key>"يعمل أي عميل MCP يدعم Streamable HTTP بالطريقة نفسها. وجّهه إلى /mcp وأرسل المفتاح الموحد كرمز Bearer. من الأدوات المفيدة healthcheck وlist_models وask_freellmapi. تشغّل أداة ask_freellmapi مهمة عبر مسار الدردشة نفسه المستخدم في الواجهة البرمجية، مع التوجيه والاحتياط.
لوكلاء البرمجة، يوفّر FreeLLMAPI أوامر إعداد تكتب إعدادات العميل نيابة عنك. من الأمثلة npx freellmapi setup-claude وsetup-codex وsetup-cline وsetup-openclaw وsetup-hermes. يدعم كل أمر --dry-run وينشئ نسخة احتياطية أولاً.
استكشاف الأخطاء وإصلاحها
| المشكلة | السبب | الحل |
|---|---|---|
| يجيب النموذج بنص ولا يستدعي أي أداة | استدعاء الأدوات ضعيف في النموذج | استخدم auto:<profile> مع نماذج تدعم استدعاء الأدوات فقط |
| يعيد الوكيل بدء المهمة في منتصفها | أجبر حد الاستخدام على تغيير النموذج | أرسل X-Session-Id وفعّل نقل السياق |
| خطأ 429 بعد خطوات كثيرة | بلغت كل المفاتيح في السلسلة حدها | أضف مزوّدين، واستخدم auto:fast للخطوات الصغيرة، وانتظر Retry-After |
خطأ 400 مع auto:name | ملف التعريف غير موجود | تحقق من اسم ملف التعريف في لوحة التحكم |
يعيد /mcp الرمز 403 | خاصية MCP مغلقة | فعّلها ضمن Agent compatibility في صفحة Keys |
| أخطاء طول السياق متأخرة في المهمة | السجل أكبر من نافذة النموذج | لخّص نتائج الأدوات القديمة، أو استخدم ملف تعريف للسياق الطويل |
الأسئلة الشائعة
هل توجد واجهة LLM مجانية لوكلاء الذكاء الاصطناعي؟
نعم. لدى عدة مزوّدين مستويات مجانية تدعم استدعاء الأدوات. يجمع FreeLLMAPI بينها خلف مفتاح واحد متوافق مع OpenAI، وينتقل إلى المزوّد التالي عندما يوقف حد الاستخدام طلباً.
ما أفضل نموذج مجاني لاستدعاء الأدوات؟
استخدم نموذجاً يدعم استدعاء الأدوات ونافذة سياق تبلغ 128 ألف رمز أو أكثر. يعرض الجدول في هذه الصفحة أقوى النماذج المجانية التي تحقق القاعدتين اليوم.
هل يمكنني استخدام FreeLLMAPI كخادم MCP؟
نعم. فعّل خاصية MCP من صفحة Keys ضمن Agent compatibility. ثم صِل عميل MCP لديك بالمسار /mcp باستخدام المفتاح الموحد كرمز Bearer.
كيف أمنع فشل الوكيل بسبب حدود الاستخدام؟
أضف مفاتيح من مزوّدين أكثر، وأرسل الخطوات الصغيرة إلى auto:fast، وأعد المحاولة عند الرمز 429 باستخدام ترويسة Retry-After، واضبط حداً أقصى لعدد الخطوات.
ماذا يحدث عند تغيير النموذج في منتصف مهمة الوكيل؟
يحصل النموذج الجديد على سجل الرسائل كاملاً. وعند تفعيل نقل السياق، يحصل أيضاً على ملاحظة قصيرة تطلب منه متابعة المهمة.
أدلة ذات صلة
- واجهة LLM مجانية مع استدعاء الدوال
- واجهة LLM مجانية في Python
- واجهة LLM مجانية لـ LangChain
- واجهة LLM مجانية لـ n8n
- كيف تستخدم Claude Code مجاناً
- حدود معدل واجهات LLM المجانية
المصادر
- FreeLLMAPI docs: REST API (tool calling, routing strategies, response headers) (تم التحقق 20 November 2026)
- FreeLLMAPI docs: clients, MCP server and context handoff (تم التحقق 20 November 2026)
- OpenAI Python SDK: errors and retries (تم التحقق 20 November 2026)
- Claude Code docs: MCP (تم التحقق 20 November 2026)