واجهة LLM مجانية مع استدعاء الدوال
يتيح استدعاء الدوال، أو استدعاء الأدوات، لنموذج LLM أن يطلب من كودك تشغيل دالة. تستخدمه الوكلاء وروبوتات الدردشة التي تعمل ببيانات حية والاستخراج المنظم. يحتوي كتالوج FreeLLMAPI على 190 عرضًا لنماذج مجانية تدعم استدعاء الأدوات. ترسل tools بصيغة OpenAI، وتحوّلها البوابة لكل مزود.
تُعرض الشيفرة وأسماء النماذج وتسميات الكتالوج المباشر باللغة الإنجليزية.
كيف يعمل استدعاء الأدوات عبر FreeLLMAPI
- ترسل الرسائل وقائمة
tools. لكل أداة اسم ووصف ومخطط JSON Schema لمعاملاتها. - يجيب النموذج بـ
tool_callsوfinish_reason: "tool_calls". لا يشغّل أي شيء بنفسه. - يشغّل كودك الدالة، ويضيف النتيجة كرسالة بالدور
role: "tool". - ترسل المحادثة مرة أخرى. يستخدم النموذج النتيجة ليكتب الإجابة النهائية.
تستقبل المزودات المتوافقة مع OpenAI، مثل Groq وCerebras وMistral وOpenRouter وCloudflare، الطلب كما هو. أما Gemini فتحوّل FreeLLMAPI الأدوات إلى صيغة functionDeclarations الخاصة بـ Google، وتحوّل الإجابة إلى الصيغة الأصلية. يبقى كودك نفسه لكل المزودين.
تكتب بعض النماذج استدعاء الأداة كنص عادي، وليس كاستدعاء أداة حقيقي. تكتشف FreeLLMAPI هذه الحالات وتحوّلها إلى tool_calls حقيقية.
نماذج مجانية تدعم استدعاء الأدوات اليوم
يعرض الجدول أقوى النماذج المجانية التي تدعم استدعاء الأدوات. تأتي البيانات من الكتالوج المباشر. بالنسبة إلى الوكلاء، تحقق أيضًا من حجم السياق، لأن تعريفات الأدوات ونتائجها تستهلك رموزًا كثيرة.
| النموذج | مجاني على | السياق | الحدود المجانية (أفضل عرض) | الأدوات | الرؤية |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 طلب/دقيقة 1 req/min per model | نعم | لا |
| Qwen3.8 Max | ACLIDE | - | €20/month shared internal usage credits · no card | نعم | لا |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 طلب/دقيقة 40 RPM | نعم | نعم |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | نعم | نعم |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 طلب/دقيقة 20 طلب/يوم 250,000 رمز/دقيقة ~3M | نعم | نعم |
| 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 | نعم | نعم |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 طلب/دقيقة 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 الأدوات وتجيب كدردشة عادية.
استكشاف الأخطاء وإصلاحها
| المشكلة | السبب | الحل |
|---|---|---|
| يجيب النموذج بنص ولا يستدعي أي أداة | النموذج ضعيف في استخدام الأدوات، أو الوصف غير واضح | ثبّت نموذجًا أقوى من الجدول، أو حسّن وصف الأداة |
json.JSONDecodeError في المعاملات | أرسل النموذج JSON غير صالح | التقط الخطأ وأرسله كنتيجة للأداة، ليحاول النموذج مرة أخرى |
| الخطأ 400 بسبب رسالة أداة | tool_call_id لا يطابق، أو رسالة المساعد مفقودة | أضف رسالة المساعد أولًا، ثم رسالة أداة واحدة لكل استدعاء |
| الخطأ 429 أثناء مهمة وكيل | ترسل الحلقة طلبات كبيرة كثيرة | أضف مفاتيح مزودين أكثر، وأرسل أدوات أقل |
| لا تتوقف الحلقة | يستدعي النموذج الأداة نفسها مرة أخرى | حدد حد الجولات، وأرجع نتائج واضحة |
الأسئلة الشائعة
أي واجهات 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. اجمع أجزاء المعاملات قبل تحليلها.
أدلة ذات صلة
- واجهة LLM مجانية لوكلاء الذكاء الاصطناعي
- واجهة بحث ويب مجانية لوكلاء الذكاء الاصطناعي
- أفضل واجهات نماذج البرمجة المجانية
- واجهة LLM مجانية لـ LangChain
- واجهة LLM مجانية في Python
المصادر
- FreeLLMAPI docs: Tool calling (تم التحقق 20 November 2026)
- FreeLLMAPI README: features (تم التحقق 20 November 2026)
- OpenAI API reference: Chat Completions tools (تم التحقق 20 November 2026)