Llama API: كيفية استخدام Llama داخل برمجياتك

الإجابة المختصرة

لاستخدام Llama برمجيًا في عام 2026، لديك خياران عمليان: إما استدعاؤه عبر موفر سحابي يستضيف نماذج Llama، أو تشغيل النموذج بنفسك واستخدام خادم محلي. لم تعد Meta توفر واجهة برمجة تطبيقات (API) مستضافة لنماذج Llama. يشرح هذا الدليل ما تغير، ثم يقدم أمثلة عملية باستخدام OpenRouter، وهي خدمة توفر واجهة API واحدة لنماذج متعددة، بما في ذلك Llama 4 Maverick وScout.

ما الذي حدث لـ API الخاص بنموذج Llama من Meta

بعد إطلاق Llama 4، أتاحت Meta واجهة Llama API مستضافة كنسخة تجريبية عامة للمطورين. لكنها أوقفت هذه المعاينة في 6 يوليو 2026. أما عرض المطورين الأحدث من Meta، وهو Meta Model API، فهو مخصص لنماذج Muse مثل Muse Wonder، وليس Llama. وتوضح صفحة المساعدة الخاصة بـ Meta ذلك بصراحة: «لا يتم تشغيل نماذج Llama نيابةً عنك عبر Model API». بعبارة أخرى، أصبح Llama الآن نموذجًا تقوم بتنزيله وتشغيله بنفسك، أو تستخدمه عبر مزودين آخرين. راجع ملاحظة Meta حول Llama وModel API.

نماذج Muse غير متوفرة في الدردشة لدينا، وأسعارها خارج نطاق هذه الصفحة. يركز باقي هذا الدليل بالكامل على Llama.

خياراتك باختصار

• موجّه النماذج (Model Router) مثل OpenRouter. مفتاح API واحد، ونقطة نهاية متوافقة مع نمط OpenAI، والعديد من النماذج. إنه خيار رائع لتجربة إصدارات Llama المختلفة والتبديل بينها بسهولة.
• مزود سحابي يستضيف Llama مباشرة. تقدم العديد من شركات الاستدلال ومنصات السحابة الكبرى نماذج Llama. قارن الأسعار وحدود الاستخدام وسياسات البيانات قبل الاختيار.
• خادمك أو حاسوبك الخاص. شغّل Llama باستخدام LM Studio أو Ollama أو llama.cpp واستدعه عبر واجهة API محلية متوافقة مع OpenAI. لا توجد تكلفة لكل رمز، مع تحكم كامل في بياناتك. راجع تشغيل Llama محليًا.

استدعاء Llama عبر OpenRouter

تتبع واجهة OpenRouter نفس تنسيق واجهة إكمال الدردشة الخاصة بـ OpenAI، لذا تعمل معظم الأكواد والمكتبات الحالية بمجرد تغيير العنوان الأساسي (base address) واسم النموذج. أنشئ حسابًا ومفتاح API على OpenRouter، ثم احفظ المفتاح في متغير بيئة باسم OPENROUTER_API_KEY، وتجنب وضعه في كود جانب العميل (client-side). الخطوات موضحة في دليل البدء السريع لـ OpenRouter.

curl

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -d '{
    "model": "meta-llama/llama-4-maverick",
    "messages": [
      {"role": "user", "content": "اكتب هايكو عن النماذج مفتوحة الأوزان."}
    ]
  }'

Python، باستخدام حزمة OpenAI SDK

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key=os.environ["OPENROUTER_API_KEY"],
)

response = client.chat.completions.create(
    model="meta-llama/llama-4-scout",
    messages=[{"role": "user", "content": "لخص ترخيص Llama في ثلاث نقاط."}],
)
print(response.choices[0].message.content)

JavaScript، باستخدام fetch

const res = await fetch("https://openrouter.ai/api/v1/chat/completions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${process.env.OPENROUTER_API_KEY}`,
  },
  body: JSON.stringify({
    model: "meta-llama/llama-3.3-70b-instruct",
    messages: [{ role: "user", content: "اقترح ثلاثة أسماء لمخبز." }],
  }),
});
const data = await res.json();
console.log(data.choices[0].message.content);

شغّل كود JavaScript كهذا على خادم، وليس داخل صفحة ويب، للحفاظ على سرية المفتاح. يدعم أيضًا ميزة البث المباشر (Streaming) إذا كنت تفضل ظهور الإجابة كلمة بكلمة.

إرسال صورة إلى Llama 4

يدعم Llama 4 Maverick وScout معالجة الصور. في التنسيق المتوافق مع نمط OpenAI، يصبح محتوى الرسالة عبارة عن قائمة تحتوي على جزء نصي وجزء مخصص للصورة:

{
  "model": "meta-llama/llama-4-maverick",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "ماذا يوجد في هذه الصورة؟"},
      {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}}
    ]
  }]
}

يعمل كلا النموذجين Llama 3.3 70B وLlama 3.1 8B مع النصوص فقط، لذا أرسل الصور دائمًا إلى أحد نماذج Llama 4.

أسماء نماذج Llama وأسعارها

هذه هي نماذج Llama المتاحة على OpenRouter، مع أسمائها الرسمية وسياق الرموز والأسعار لكل مليون رمز. جميع الأسعار مأخوذة من قائمة أسعار OpenRouter لشهر أكتوبر 2026؛ وهي قابلة للتغيير، لذا تحقق منها قبل بناء ميزانيتك عليها.

يُرجى ملاحظة أن نوافذ السياق المذكورة هنا هي ما يوفره مزودو OpenRouter، والتي قد تكون أقل مما توضحه بطاقات نماذج Meta الرسمية. حيث تسجل Meta نحو 10 ملايين رمز لنموذج Scout ومليون رمز لنموذج Maverick.

استخدام نموذج Llama محلي كـ API

إذا قمت بتشغيل Llama بنفسك، يمكنك توجيه نفس الكود نحو جهازك المحلي. يستخدم خادم LM Studio العنوان http://localhost:1234/v1 كعنوان أساسي، كما يقوم أمر llama serve في llama.cpp بتشغيل خادم متوافق مع OpenAI؛ راجع توثيق خادم LM Studio وملف README الخاص بـ llama.cpp. يمتلك Ollama واجهة API خاصة به عبر http://localhost:11434/api/chat. استخدم اسم النموذج الذي تظهره أداتك المحلية بدلاً من اسم OpenRouter.

نصائح للتطوير باستخدام Llama

• ابدأ بنموذج Maverick أو Scout للمهام العامة والصور، وجرب Llama 3.1 8B عندما تكون السرعة والتكلفة أهم من التعمق.
• حدد توجيه نظام (System Prompt) يوضح الدور والنبرة وتنسيق المخرجات المطلوب بدقة.
• أضف طبقة حماية وأمان للتطبيقات العامة. يمكن لـ Llama Guard 4 تصنيف المدخلات والإجابات وتصفيتها.
• التزم ببنود الترخيص. يجب أن تعرض المنتجات المطورة باستخدام Llama عبارة "Built with Llama" وأن تلتزم بسياسة الاستخدام المقبول لـ Meta. اقرأ دليل الترخيص لدينا.
• انتبه لتاريخ انقطاع البيانات. تم تدريب Llama 4 على أحداث تصل حتى أغسطس 2024؛ زوّد النموذج بالحقائق والمعلومات الحديثة داخل التوجيه عند الحاجة.

مشاكل شائعة

• أخطاء المصادقة (Authorization errors): تعني عادةً أن المفتاح مفقود أو كُتب بشكل خاطئ أو لم يتم تحميله في البيئة التي يعمل بها الكود.
• خطأ "Model not found": يشير غالبًا إلى خطأ مطبعي في اسم النموذج. انسخه تمامًا من الجدول أعلاه، بما في ذلك بادئة meta-llama/.
• تجاهل الصورة أو رفضها: يحدث هذا عند إرسال صورة إلى نموذج يدعم النصوص فقط. انتقل إلى Maverick أو Scout.
• توقف الإجابات فجأة: يعني أن الرد وصل إلى الحد الأقصى للمخرجات المسموح بها. اطلب إجابة أقصر أو ارفع حد الرموز القصوى (max tokens).

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

هل لا تزال Meta تقدم واجهة برمجة تطبيقات (API) لـ Llama؟

لا. أنهت Meta المعاينة التجريبية لواجهة Llama API المستضافة في 6 يوليو 2026. وتقدم واجهة Meta Model API الخاصة بها نماذج Muse فقط وليس Llama.

هل توجد واجهة API مجانية لـ Llama؟

تشغيل Llama محليًا لا يكلف أي شيء لكل رمز. أما واجهات API المستضافة فتفرض رسومًا لكل رمز، رغم أن النماذج الصغيرة مثل Llama 3.1 8B منخفضة التكلفة للغاية.

هل يوفر Llama.Online واجهة برمجة تطبيقات (API)؟

لا. يقتصر Llama.Online على الدردشة عبر المتصفح فقط. استخدم مزودًا سحابيًا أو خادمًا محليًا للاستخدام البرمجي.

هل يمكنني استخدام حزمة OpenAI SDK مع Llama؟

نعم. وجّه الحزمة إلى نقطة نهاية متوافقة مع نمط OpenAI، مثل OpenRouter أو خادم LM Studio محلي، واستخدم اسم أحد نماذج Llama.