الرئيسية / الأدلة / واجهة LLM مجانية لوكلاء الذكاء الاصطناعي

واجهة LLM مجانية لوكلاء الذكاء الاصطناعي

يرسل وكيل الذكاء الاصطناعي طلبات كثيرة إلى النموذج لتنفيذ مهمة واحدة. تحتاج كل خطوة إلى استدعاء الأدوات وسياق كبير. مستوى مجاني واحد يوقف الوكيل بسرعة. يجمع FreeLLMAPI 45 مستوى مجانياً من المزوّدين خلف مفتاح واحد متوافق مع OpenAI. ينتقل إلى المزوّد التالي عندما يوقف حد الاستخدام طلباً، فيستطيع الوكيل المتابعة. يغطي هذا الدليل استدعاء الأدوات، والتوجيه لكل خطوة، والجلسات الطويلة، وخادم MCP الخاص بالموجّه.

تُعرض الشيفرة وأسماء النماذج وتسميات الكتالوج المباشر باللغة الإنجليزية.

ما يحتاجه الوكيل من واجهة مجانية

الحاجةالسببما يفعله FreeLLMAPI
استدعاء الأدواتيختار الوكيل الأدوات ويشغّلهايمرّر tools بصيغة OpenAI إلى كل مزوّد. يحوّل استدعاءات الأدوات المكتوبة كنص عادي إلى tool_calls حقيقية.
طلبات كثيرةقد تأخذ مهمة واحدة من 20 إلى 100 خطوةيحسب حصة كل مفتاح وينتقل إلى المفتاح أو المزوّد التالي عند الرمز 429
سياق كبيرتكبر نتائج الأدوات والسجل في كل خطوةيوجّه إلى نماذج من سلسلتك. يمكنك إنشاء ملف تعريف للسياق الطويل.
سلوك ثابتقد يربك تغيير النموذج في منتصف المهمة الوكيليُبقي الجلسة على نموذج واحد لمدة 30 دقيقة. يمكن تفعيل نقل السياق عند حدوث تغيير.
الرؤيةيجب أن تعرف أي نموذج فشلترويسات X-Routed-Via وX-Fallback-Trail في كل استجابة

للمستويات المجانية حدود. يوزّع الاحتياط الحمل على مفاتيحك، لكن المجموع يبقى مجموع الحدود المجانية. أضف مفاتيح من أربعة مزوّدين أو أكثر لأعمال الوكلاء.

نماذج مجانية تدعم استدعاء الأدوات وسياقاً يبلغ 128K+
النموذجمجاني علىالسياقالحدود المجانية (أفضل عرض)الأدواتالرؤية
GLM 5.3UnoRouter1M1 طلب/دقيقة
1 req/min per model
نعملا
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 طلب/دقيقة
40 RPM
نعمنعم
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaنعمنعم
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceنعملا
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditنعمنعم
Gemini 3.7 FlashGoogle AI Studio1M10 طلب/دقيقة
20 طلب/يوم
250,000 رمز/دقيقة
~3M
نعمنعم
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditنعمنعم
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 طلب/دقيقة
50 طلب/يوم
50 req/day account-wide (1,000 after a $10 purchase)
نعمنعم
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 طلب/دقيقة
50 طلب/يوم
Shared rate limit
نعملا
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 طلب/دقيقة
250 طلب/يوم
70,000 رمز/دقيقة
~6M
نعمنعم
Gemini 3.6 FlashGoogle AI Studio1M10 طلب/دقيقة
20 طلب/يوم
250,000 رمز/دقيقة
~3M
نعمنعم
Qwen 3.8 27BCloudflare Workers AI262KShared 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
أخطاء طول السياق متأخرة في المهمةالسجل أكبر من نافذة النموذجلخّص نتائج الأدوات القديمة، أو استخدم ملف تعريف للسياق الطويل
استخدم كل واحد من هذه النماذج عبر مفتاح واحد. FreeLLMAPI موجّه مفتوح المصدر تستضيفه بنفسك. يضع كل هذه المستويات المجانية خلف نقطة وصول واحدة متوافقة مع OpenAI، ويتحول تلقائيًا إلى مزوّد آخر عند تجاوز حد الطلبات. تصفح الكتالوج أو ابدأ الآن.

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

هل توجد واجهة LLM مجانية لوكلاء الذكاء الاصطناعي؟

نعم. لدى عدة مزوّدين مستويات مجانية تدعم استدعاء الأدوات. يجمع FreeLLMAPI بينها خلف مفتاح واحد متوافق مع OpenAI، وينتقل إلى المزوّد التالي عندما يوقف حد الاستخدام طلباً.

ما أفضل نموذج مجاني لاستدعاء الأدوات؟

استخدم نموذجاً يدعم استدعاء الأدوات ونافذة سياق تبلغ 128 ألف رمز أو أكثر. يعرض الجدول في هذه الصفحة أقوى النماذج المجانية التي تحقق القاعدتين اليوم.

هل يمكنني استخدام FreeLLMAPI كخادم MCP؟

نعم. فعّل خاصية MCP من صفحة Keys ضمن Agent compatibility. ثم صِل عميل MCP لديك بالمسار /mcp باستخدام المفتاح الموحد كرمز Bearer.

كيف أمنع فشل الوكيل بسبب حدود الاستخدام؟

أضف مفاتيح من مزوّدين أكثر، وأرسل الخطوات الصغيرة إلى auto:fast، وأعد المحاولة عند الرمز 429 باستخدام ترويسة Retry-After، واضبط حداً أقصى لعدد الخطوات.

ماذا يحدث عند تغيير النموذج في منتصف مهمة الوكيل؟

يحصل النموذج الجديد على سجل الرسائل كاملاً. وعند تفعيل نقل السياق، يحصل أيضاً على ملاحظة قصيرة تطلب منه متابعة المهمة.

أدلة ذات صلة

المصادر

كل الأدلة · تصفح كل النماذج المجانية