واجهة API للذكاء الاصطناعي: ما الذي ترسله وما يعود؟

تريد إضافة ميزة تلخيص إلى تطبيقك. لا تحتاج إلى تنزيل نموذج لغوي، ولا شراء وحدة معالجة رسومية، ولا بناء خادم لاستضافته. ترسل النصّ إلى واجهة برمجة تطبيقات، وتستلم التلخيص في استجابة منظَّمة.

واجهة برمجة التطبيقات (API) عقد اتصال بين برنامجين. في تطبيقات الذكاء الاصطناعي يرسل تطبيقك طلبًا عبر الشبكة إلى مزوّد يشغّل النموذج، فيعيد المزوّد النصّ أو التصنيف أو الصورة الناتجة.

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

هي نقطة اتصال برمجية تتيح لتطبيقك استعمال نموذج مستضاف. تستدعي عنوانًا عبر HTTPS، وترسل طلبًا بصيغة JSON، وتستقبل استجابة بالصيغة نفسها.

لا يختلف المبدأ عن طلب معلومات الطقس من خدمة خارجية. الفرق أن الخادم البعيد يشغّل نموذجًا ثم يعيد ناتج الاستدلال. والمسار المبسّط:

تطبيقك
  └─ طلب HTTPS فيه نصّ وتعليمات
      └─ واجهة المزوّد
          └─ تشغيل الاستدلال على النموذج
              └─ استجابة JSON فيها المخرَج والاستهلاك
                  └─ تطبيقك يعرض النتيجة

يشغّل المزوّد النموذج والعتاد والتوسعة في الخلفية، ويتعامل تطبيقك مع الطلب والاستجابة فقط.

ما الذي ترسله في الطلب؟

تختلف أسماء الحقول بين المزوّدين، لكن العناصر متشابهة:

• النموذج: اسم النموذج المطلوب. يحدّد القدرة والسرعة وحدّ السياق والتسعير.
• الرسائل أو الموجّه: تعليمات النظام، وطلب المستخدم، وسجلّ المحادثة عند الحاجة. وبنية الموجّه الجيّد في كتابة prompt.
• إعدادات التوليد: الحدّ الأقصى لرموز المخرَج، ودرجة الحرارة التي تؤثّر في التنوّع.
• الأدوات أو شكل المخرَج: قد تطلب JSON منظَّمًا، أو تسمح للنموذج بطلب أداة.
• مفتاح API: سرّ يثبت أن تطبيقك مخوَّل. يُحفَظ في الخادم لا في المتصفّح ولا في تطبيق الهاتف.

مثال مبسّط لطلب محادثة:

{
  "model": "اسم-النموذج",
  "messages": [
    { "role": "system", "content": "أجب بالعربية الفصحى وباختصار." },
    { "role": "user", "content": "لخّص هذا النص في ثلاث نقاط: ..." }
  ],
  "max_tokens": 250,
  "temperature": 0.2
}

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

ما الذي يعود في الاستجابة؟

وقد يعود النصّ دفعةً واحدة، أو على أجزاء متتابعة عبر البثّ (Streaming) — وهو مفيد في واجهات المحادثة لأن المستخدم يرى بداية الإجابة قبل اكتمالها.

لماذا لا تشغّل النموذج بنفسك؟

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

فإن كانت لديك متطلّبات صارمة لمكان بقاء البيانات، أو حمل ثابت وكبير جدًّا، أو حاجة إلى نموذج مخصّص، فقد يصير التشغيل الذاتي منطقيًّا.

التكلفة والحدود

تُحاسَب الخدمات عادةً بعدد رموز المدخل والمخرَج، وسعر رموز المخرَج أعلى غالبًا. ولذلك لا ترسل سجلّ محادثة كاملًا بلا حاجة، ولا تطلب مخرجات طويلة إذا كانت واجهتك تحتاج جملة واحدة. وللعربية شأن خاص هنا: تستهلك رموزًا أكثر، وتفصيله في ما هو token؟.

وضع مفتاح API في متغيّرات بيئة على الخادم، وطبّق حدود استعمال ومراقبة للأخطاء. المفتاح المسرَّب يسمح لغيرك باستهلاك حسابك.

متى لا تحتاج إلى واجهة API؟

• عند التجربة الشخصية داخل واجهة جاهزة.
• حين لا يوجد تطبيق أو سير عمل آلي.
• عند تشغيل نموذج محلّي صغير لأغراض تعليمية.

متى تحتاج إلى فهمها بعمق؟

• عند بناء ميزة داخل منتج: بنية الطلب، وإدارة الأخطاء، والتكاليف، وحدود المعدّل.
• عند التعامل مع بيانات حسّاسة: قيّم شروط المزوّد وموقع المعالجة وسياسة الاحتفاظ.
• عند ارتفاع الاستعمال: قِس الرموز وزمن الاستجابة وتكلفة الطلب.

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

هل يعمل النموذج داخل تطبيقي؟

لا. تطبيقك يرسل طلبًا إلى خادم بعيد يشغّل النموذج ثم يستقبل النتيجة.

هل أرسل سؤال المستخدم فقط؟

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

هل أحتاج وحدة معالجة رسومية؟

لا. هي تعمل لدى المزوّد. تحتاج أنت إلى خادم يرسل طلبًا آمنًا ويعالج الاستجابة.

متى يكون التشغيل الذاتي أفضل؟

حين تحتاج إبقاء البيانات في بيئتك، أو تحكّمًا كاملًا في النموذج، أو حين يكون لديك حمل ثابت كبير يبرّر تكلفة العتاد والفريق.

المراجع

1. OpenAI. API Reference. platform.openai.com
2. Anthropic. Messages API. docs.anthropic.com
3. Google. Gemini API — text generation. ai.google.dev
4. Mozilla. An overview of HTTP. developer.mozilla.org
5. OWASP. API Security Top 10. owasp.org