إنتقل إلى المحتوى الرئيسي

الفصل 1: استخدام واجهات API لنماذج LLM

كيف تتصل التطبيقات بنماذج LLM​

عندما تستخدم ChatGPT عبر الموقع، تستخدم واجهة مستخدم. لكن كيف تدمج التطبيقات والمواقع والخدمات نماذج LLM في منتجاتها؟ عبر واجهات API.

ما هي API؟​

تعريف بسيط

API (Application Programming Interface) طريقة تتواصل بها تطبيقات برمجية مختلفة مع بعضها.

تشبيه المطعم​

فكّر في API كطلب الطعام في مطعم:

المطعمAPI
أنت (الزبون)تطبيقك
القائمةتوثيق API
النادلالـ API نفسها
المطبخخدمة LLM
طلبكطلب API الخاص بك
طعامكرد نموذج LLM

لا تدخل المطبخ — تتواصل عبر النادل (API)، الذي يأخذ طلبك (request) إلى المطبخ (LLM) ويعود بطعامك (response).

ChatGPT مقابل API​

هذان طريقان مختلفان للوصول إلى التقنية نفسها:

الجانبموقع/تطبيق ChatGPTOpenAI API
المستخدمالمستخدمون العاديونالمطوّرون
الواجهةنافذة دردشةشيفرة
التسعيراشتراك شهريالدفع حسب الاستخدام (tokens)
التخصيصمحدودواسع
حالة الاستخدامإنتاجية شخصيةبناء منتجات

كيف تعمل استدعاءات API​

تدفق مبسط​

ما يدخل في الطلب​

  1. مفتاح API الخاص بك: يعرّفك ويوثّقك
  2. النموذج: أي نموذج LLM يُستخدم (مثل gpt-4، claude-3)
  3. الـ Prompt: ما تريد من النموذج فعله
  4. الـ Parameters: إعدادات مثل temperature وmax tokens

ما يعود​

  1. النص المولَّد: رد نموذج LLM
  2. معلومات الاستخدام: كم token استُخدم
  3. بيانات وصفية: إصدار النموذج، معلومات التوقيت

مثال API بسيط (مفاهيمي)​

لا تحتاج إلى البرمجة، لكن إليك شكل استدعاء API:

// Conceptual example - not code to run
Request:
{
  "model": "gpt-4",
  "messages": [
    {"role": "system", "content": "You are a helpful assistant"},
    {"role": "user", "content": "What is the capital of France?"}
  ],
  "temperature": 0.7
}

Response:
{
  "choices": [
    {"message": {"content": "The capital of France is Paris."}}
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 8,
    "total_tokens": 33
  }
}

أبرز مزوّدي API​

OpenAI API​

  • النماذج: GPT-4, GPT-3.5-turbo
  • نقاط القوة: الأكثر شعبية، موثّق جيداً
  • الوصول: api.openai.com

Anthropic API​

  • النماذج: Claude 3 (Opus, Sonnet, Haiku)
  • نقاط القوة: سياق طويل، تركيز على السلامة
  • الوصول: anthropic.com

Google AI​

  • النماذج: Gemini Pro, Gemini Ultra
  • نقاط القوة: متعدد الوسائط، تكامل Google
  • الوصول: ai.google.dev

Azure OpenAI​

  • النماذج: نفسها لدى OpenAI، عبر Microsoft
  • نقاط القوة: ميزات مؤسسية، امتثال
  • الوصول: azure.microsoft.com

خيارات دون برمجة​

لا تحتاج إلى أن تكون مطوّراً لاستخدام واجهات API لنماذج LLM!

أدوات دون برمجة​

الأداةماذا تفعل
Zapierربط نماذج LLM بتطبيقات أخرى دون شيفرة
Make (Integromat)أتمتة مرئية مع الذكاء الاصطناعي
LangFlowبرمجة مرئية لتطبيقات LLM
ChatGPT GPT Builderإنشاء نماذج GPT مخصّصة دون برمجة

منصات منخفضة الشيفرة​

المنصةحالة الاستخدام
Microsoft Power Platformأتمتة مؤسسية
Bubbleتطبيقات ويب مع ذكاء اصطناعي
Retoolأدوات داخلية

مفاهيم API أساسية​

المصادقة​

مفتاح API الخاص بك مثل كلمة مرور — أبقه سراً!

حدود المعدّل​

حدود على الطلبات في الدقيقة لمنع الإثقال:

  • المستويات المجانية: نحو 3 طلبات/دقيقة
  • المستويات المدفوعة: نحو 60+ طلباً/دقيقة

نقاط النهاية (Endpoints)​

عناوين URL مختلفة لوظائف مختلفة:

  • /chat/completions - ردود الدردشة
  • /embeddings - تحويل النص إلى أرقام
  • /audio/transcriptions - تحويل الكلام إلى نص

البث (Streaming)​

استقبال الردود كلمة بكلمة أثناء توليدها (مثل كتابة ChatGPT).

حالات استخدام شائعة​

1. روبوتات دعم العملاء​

  • الدمج في موقع أو تطبيق
  • معالجة الأسئلة الشائعة
  • تصعيد المسائل المعقّدة

2. توليد المحتوى​

  • مسودات البريد الإلكتروني
  • نصوص تسويقية
  • أوصاف المنتجات

3. معالجة البيانات​

  • تلخيص المستندات
  • استخراج المعلومات
  • تصنيف المحتوى

4. المساعدة في الشيفرة​

  • توليد مقتطفات شيفرة
  • شرح الشيفرة
  • إصلاح الأخطاء

الاختيار بين المنتج الاستهلاكي وAPI​

اختر المنتج الاستهلاكي (ChatGPT/Claude) عندما...اختر API عندما...
استخدام شخصيبناء منتج
استخدام عرضيتحتاج إلى أتمتة
استكشاف الذكاء الاصطناعيحجم مرتفع
مهام بسيطةتكامل مخصّص

النقاط الأساسية​

✅ تسمح واجهات API للتطبيقات بالتواصل مع خدمات LLM

✅ ChatGPT للمستهلكين؛ وواجهات API لبناء المنتجات

✅ تشمل استدعاءات API مفتاحك واختيار النموذج والـ prompt والإعدادات

✅ أدوات دون برمجة تجعل واجهات API في متناول غير المطوّرين

✅ حدود المعدّل والمصادقة اعتبارات مهمة

فكّر في ذلك​

  1. أي نوع من التطبيقات قد تبنيه لو كان لديك وصول API إلى نموذج LLM؟
  2. لماذا تستخدم شركة الـ API بدلاً من مجرد توجيه الموظفين لاستخدام ChatGPT؟
  3. ما المخاوف الأمنية التي قد تنشأ من استخدام مفاتيح API؟

الخطوات التالية​

الآن نفهم التكاليف في الفصل 2: الـ Tokens والتسعير.