الرئيسية / الأدلة / واجهة LLM مجانية مع استدعاء الدوال

واجهة LLM مجانية مع استدعاء الدوال

يتيح استدعاء الدوال، أو استدعاء الأدوات، لنموذج LLM أن يطلب من كودك تشغيل دالة. تستخدمه الوكلاء وروبوتات الدردشة التي تعمل ببيانات حية والاستخراج المنظم. يحتوي كتالوج FreeLLMAPI على 190 عرضًا لنماذج مجانية تدعم استدعاء الأدوات. ترسل tools بصيغة OpenAI، وتحوّلها البوابة لكل مزود.

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

كيف يعمل استدعاء الأدوات عبر FreeLLMAPI

  1. ترسل الرسائل وقائمة tools. لكل أداة اسم ووصف ومخطط JSON Schema لمعاملاتها.
  2. يجيب النموذج بـ tool_calls وfinish_reason: "tool_calls". لا يشغّل أي شيء بنفسه.
  3. يشغّل كودك الدالة، ويضيف النتيجة كرسالة بالدور role: "tool".
  4. ترسل المحادثة مرة أخرى. يستخدم النموذج النتيجة ليكتب الإجابة النهائية.

تستقبل المزودات المتوافقة مع OpenAI، مثل Groq وCerebras وMistral وOpenRouter وCloudflare، الطلب كما هو. أما Gemini فتحوّل FreeLLMAPI الأدوات إلى صيغة functionDeclarations الخاصة بـ Google، وتحوّل الإجابة إلى الصيغة الأصلية. يبقى كودك نفسه لكل المزودين.

تكتب بعض النماذج استدعاء الأداة كنص عادي، وليس كاستدعاء أداة حقيقي. تكتشف FreeLLMAPI هذه الحالات وتحوّلها إلى tool_calls حقيقية.

نماذج مجانية تدعم استدعاء الأدوات اليوم

يعرض الجدول أقوى النماذج المجانية التي تدعم استدعاء الأدوات. تأتي البيانات من الكتالوج المباشر. بالنسبة إلى الوكلاء، تحقق أيضًا من حجم السياق، لأن تعريفات الأدوات ونتائجها تستهلك رموزًا كثيرة.

نماذج مجانية تدعم استدعاء الأدوات، الأقوى أولًا
النموذجمجاني علىالسياقالحدود المجانية (أفضل عرض)الأدواتالرؤية
GLM 5.3UnoRouter1M1 طلب/دقيقة
1 req/min per model
نعملا
Qwen3.8 MaxACLIDE-€20/month shared internal usage credits · no cardنعملا
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 طلب/دقيقة
40 RPM
نعمنعم
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaنعمنعم
Gemini Flash (latest alias)Google AI Studio-10 طلب/دقيقة
20 طلب/يوم
250,000 رمز/دقيقة
~3M
نعمنعم
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نعمنعم
Gemini 3.5 FlashGoogle AI Studio1M10 طلب/دقيقة
20 طلب/يوم
250,000 رمز/دقيقة
~3M
نعمنعم

يعرض 15 من أصل 146 نموذجًا مجانيًا مطابقًا. عرض كل النماذج.

بيانات مباشرة من كتالوج FreeLLMAPI (الإصدار 2026.11.19، تم التحقق 2026-11-19). تتغير الحدود المجانية كثيرًا. يُفحص الكتالوج كل يوم.

الخطوة 1: ثبّت FreeLLMAPI وأضف المفاتيح

FreeLLMAPI مفتوحة المصدر. تعمل على حاسوبك في Docker. تبقى مفاتيح المزودين على حاسوبك.

التثبيت (macOS أو Linux)

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

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

الخطوة 2: شغّل حلقة أدوات كاملة

curl: الطلب الأول

curl http://localhost:3001/v1/chat/completions \
  -H "Authorization: Bearer <unified-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "messages": [{"role": "user", "content": "What is the weather in Karachi?"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get the current weather for a city.",
        "parameters": {
          "type": "object",
          "properties": {"city": {"type": "string"}},
          "required": ["city"]
        }
      }
    }]
  }'

Python: كرر الحلقة حتى يعطي النموذج إجابة نهائية

import json
from openai import OpenAI

client = OpenAI(base_url="http://localhost:3001/v1", api_key="<unified-key>")

def get_weather(city: str) -> dict:
    return {"city": city, "temp_c": 32, "condition": "sunny"}  # call a real API here

FUNCS = {"get_weather": get_weather}
tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "Get the current weather for a city.",
        "parameters": {
            "type": "object",
            "properties": {"city": {"type": "string"}},
            "required": ["city"],
        },
    },
}]
messages = [{"role": "user", "content": "What is the weather in Karachi and Lahore?"}]

for _ in range(5):  # stop after 5 rounds
    msg = client.chat.completions.create(model="auto", messages=messages, tools=tools).choices[0].message
    if not msg.tool_calls:
        print(msg.content)
        break
    messages.append(msg)
    for call in msg.tool_calls:
        try:
            args = json.loads(call.function.arguments or "{}")
            result = FUNCS[call.function.name](**args)
        except Exception as exc:  # bad JSON, unknown tool or wrong arguments
            result = {"error": str(exc)}
        messages.append({"role": "tool", "tool_call_id": call.id, "content": json.dumps(result)})

يعمل استدعاء الأدوات أيضًا مع stream=True. تحصل على أجزاء delta.tool_calls، ثم جزء أخير بالقيمة finish_reason: "tool_calls". اجمع أجزاء المعاملات قبل تحليل JSON.

استخدم أداة للحصول على بيانات منظمة

يُعد استدعاء الأدوات طريقة جيدة للحصول على بيانات بشكل ثابت. عرّف أداة واحدة تكون معاملاتها الحقول التي تريدها. اضبط tool_choice على "required"، ليجب على النموذج استدعاء أداة. ثم اقرأ المعاملات. لا تحتاج إلى تشغيل أي دالة.

Python: استخرج الحقول باستدعاء أداة إلزامي

import json
from openai import OpenAI

client = OpenAI(base_url="http://localhost:3001/v1", api_key="<unified-key>")
schema = {
    "type": "function",
    "function": {
        "name": "save_contact",
        "description": "Save one contact found in the text.",
        "parameters": {
            "type": "object",
            "properties": {"name": {"type": "string"}, "email": {"type": "string"}},
            "required": ["name", "email"],
        },
    },
}
resp = client.chat.completions.create(
    model="auto",
    messages=[{"role": "user", "content": "Reach Sara Khan at [email protected]."}],
    tools=[schema],
    tool_choice="required",
)
print(json.loads(resp.choices[0].message.tool_calls[0].function.arguments))

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

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

المحاذير

  • المعاملات نص: function.arguments سلسلة JSON. حللها، والتقط الأخطاء. ترسل النماذج الصغيرة أحيانًا JSON غير صالح.
  • طابق المعرّفات: تحتاج كل رسالة أداة إلى tool_call_id الخاص بالاستدعاء الذي تجيب عنه. أضف رسالة المساعد التي تحتوي على tool_calls قبل رسائل الأدوات.
  • استدعاءات متعددة في وقت واحد: قد يعيد النموذج أكثر من استدعاء أداة في إجابة واحدة. شغّلها كلها، ثم أرسل كل النتائج.
  • تكلفة الرموز: يُرسل كل تعريف أداة مع كل طلب. قد تستهلك عشرون أداة كبيرة آلاف الرموز، وتبلغ حد الرموز في الدقيقة المنخفض بسرعة. أرسل الأدوات التي تحتاجها المهمة فقط.
  • أوصاف واضحة: يختار النموذج الأداة من اسمها ووصفها. اكتب جملة قصيرة واحدة تقول ما تفعله الأداة ومتى تُستخدم.
  • أوقف الحلقة: حدد أقصى عدد من الجولات. قد يستدعي نموذج ضعيف الأداة نفسها مرارًا.
  • نماذج بلا أدوات: لا تدعم بعض المزودين المجانيين الأدوات. مثلًا، تتجاهل AI Horde الأدوات وتجيب كدردشة عادية.
النموذج نفسه أثناء المهمة: تحتفظ FreeLLMAPI بالمحادثة على نموذج واحد لمدة 30 دقيقة. تبقى حلقة الأدوات عادة على نموذج واحد. إذا فرض حد تغييرًا، يتلقى النموذج التالي سجل الرسائل كاملًا، بما في ذلك نتائج الأدوات.

استكشاف الأخطاء وإصلاحها

المشكلةالسببالحل
يجيب النموذج بنص ولا يستدعي أي أداةالنموذج ضعيف في استخدام الأدوات، أو الوصف غير واضحثبّت نموذجًا أقوى من الجدول، أو حسّن وصف الأداة
json.JSONDecodeError في المعاملاتأرسل النموذج JSON غير صالحالتقط الخطأ وأرسله كنتيجة للأداة، ليحاول النموذج مرة أخرى
الخطأ 400 بسبب رسالة أداةtool_call_id لا يطابق، أو رسالة المساعد مفقودةأضف رسالة المساعد أولًا، ثم رسالة أداة واحدة لكل استدعاء
الخطأ 429 أثناء مهمة وكيلترسل الحلقة طلبات كبيرة كثيرةأضف مفاتيح مزودين أكثر، وأرسل أدوات أقل
لا تتوقف الحلقةيستدعي النموذج الأداة نفسها مرة أخرىحدد حد الجولات، وأرجع نتائج واضحة
استخدم كل واحد من هذه النماذج عبر مفتاح واحد. FreeLLMAPI موجّه مفتوح المصدر تستضيفه بنفسك. يضع كل هذه المستويات المجانية خلف نقطة وصول واحدة متوافقة مع OpenAI، ويتحول تلقائيًا إلى مزوّد آخر عند تجاوز حد الطلبات. تصفح الكتالوج أو ابدأ الآن.

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

أي واجهات LLM مجانية تدعم استدعاء الدوال؟

لدى Gemini وGroq وCerebras وMistral وOpenRouter وCloudflare ومزودين آخرين نماذج مجانية تدعم استدعاء الأدوات. يحتوي كتالوج FreeLLMAPI اليوم على 190 عرضًا لنماذج مجانية مع أدوات.

هل استدعاء الأدوات هو نفسه استدعاء الدوال؟

نعم. استخدمت OpenAI الاسم استدعاء الدوال أولًا. تستخدم الواجهة الحالية tools وtool_calls. يعني الاسمان أن النموذج يطلب من كودك تشغيل دالة.

هل يعمل استدعاء أدوات Gemini بصيغة OpenAI؟

نعم، عبر FreeLLMAPI. تحوّل البوابة أدوات OpenAI إلى functionDeclarations الخاصة بـ Gemini، وتحوّل الإجابة مرة أخرى إلى tool_calls بصيغة OpenAI.

هل يمكنني بث استدعاءات الأدوات؟

نعم. مع stream=True تحصل على أجزاء delta.tool_calls، وقيمة finish_reason النهائية هي tool_calls. اجمع أجزاء المعاملات قبل تحليلها.

أدلة ذات صلة

المصادر

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