كيف تستخدم واجهات LLM API: الرموز والتكاليف والمفاتيح وأول ميزة ذكاء اصطناعي

واجهة LLM API خدمة ويب تتيح لتطبيقك إرسال نص إلى نموذج لغوي كبير، مثل GPT من OpenAI أو Claude من Anthropic أو Gemini من Google، واستلام رده في الكود. تسجّل لدى المزوّد، وتنشئ مفتاح API، ويرسل خادم تطبيقك الطلبات بهذا المفتاح، وتُحاسَب على كل طلب بعدد الرموز (أجزاء النص) الداخلة والخارجة. هذا كل ما يعنيه عادةً «إضافة الذكاء الاصطناعي إلى تطبيق»: طلب مكتوب جيدًا إلى نموذج يملكه غيرك، يُرسل بأمان من خادمك.

لماذا يهم هذا عند البناء بالذكاء الاصطناعي؟

في التطبيق المبني بالذكاء الاصطناعي يوجد ذكاءان مختلفان، ومن السهل الخلط بينهما:

1. الذكاء الاصطناعي الذي يبني تطبيقك: وكيل أداة البناء، وهو الذي يكتب الكود.
2. الذكاء الاصطناعي داخل تطبيقك: ميزة يستخدمها مستخدموك، مثل مساعد دردشة أو زر «لخّص هذا» أو وسم تلقائي.

الثاني يستدعي واجهة LLM API بمفتاحك، ويُحاسَب على حساب المزوّد الخاص بك. فهم الرموز والسياق والتسعير يتيح لك تصميم ميزة تعمل، ولا تكشف مفتاحك، ولا تفاجئك بفاتورة.

تشبيه يومي: كاتب مستقل بارع يُدفع له بالكلمة

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

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

المفاهيم الأساسية

الرموز

تقرأ النماذج النص وتكتبه بالرموز. تقدّر وثائق التسعير لدى Anthropic أن الرمز نحو 4 أحرف، أو ما يقارب 0.75 كلمة إنجليزية، وذلك حتى سبتمبر 2026. تختلف النماذج واللغات في طريقة تقسيم النص إلى رموز، فاعتبر ذلك تقديرًا تقريبيًا. كل شيء يُحتسب: تعليماتك، ورسالة المستخدم، وأي مستندات تضيفها، والمحادثة السابقة، والرد.

المدخلات والمخرجات

رموز المدخلات هي ما ترسله. رموز المخرجات هي ما يكتبه النموذج. في صفحات التسعير لدى OpenAI وAnthropic وGoogle، حتى سبتمبر 2026، تكلّف رموز المخرجات عدة أضعاف رموز المدخلات للنموذج نفسه. وتشير صفحة تسعير Gemini من Google أيضًا إلى أن «التفكير» الداخلي للنموذج يُحتسب ضمن المخرجات.

نافذة السياق

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

الطلبات عديمة الحالة

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

تعليمات النظام

تعليمات تحدد دور النموذج وقواعده في كل طلب، مثل: «أنت تلخّص تذاكر الدعم في ثلاث نقاط. لا تُدرج أبدًا عناوين البريد الإلكتروني للعملاء.» لا يراها المستخدمون، لكنها تشكّل كل رد.

البث (Streaming)

بدل انتظار الإجابة كاملة، يمكن للواجهة أن ترسل النص أثناء توليده، فيرى المستخدمون الكلمات تظهر فورًا. وهذا يجعل واجهات الدردشة تبدو أسرع بكثير.

كيف يعمل التسعير

حتى سبتمبر 2026، وحسب صفحات التسعير لدى المزوّدين أنفسهم:

بعض المزوّدين يتيحون أيضًا طريقة للتجربة قبل الدفع: تمنح Anthropic المستخدمين الجدد رصيدًا مجانيًا صغيرًا، ولدى واجهة Gemini من Google مستوى مجاني على بعض النماذج، مع تنبيه بأن المحتوى المُرسل عليه قد يُستخدم لتحسين منتجات Google.

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

مثال عملي: زر «لخّص هذه التذكرة»

يريد فريق دعم صغير زرًا يحوّل سلسلة بريد إلكتروني طويلة من العميل إلى ثلاث نقاط واقتراح رد.

1. احصل على مفتاح. أنشئ حسابًا لدى مزوّد واحد، وولّد مفتاح API. اضبط حدًا شهريًا منخفضًا للإنفاق.
2. خزّن المفتاح كسر على خادمك، باسم مثل ANTHROPIC_API_KEY أو OPENAI_API_KEY، ولا تضعه أبدًا في كود الصفحة. راجع متغيرات البيئة والأسرار.
3. أضف مسارًا على الخادم، POST /api/summarise، يقوم بما يلي:
   • يتحقق من أن الشخص مسجّل الدخول وينتمي إلى فريق الدعم؛
   • يحمّل التذكرة من قاعدة البيانات؛
   • يرسل إلى المزوّد تعليمات النظام («لخّص في ثلاث نقاط، ثم اكتب ردًا مهذبًا؛ لا تخترع أرقام طلبات») مع نص التذكرة؛
   • يحدّ من طول الرد بإعداد الحد الأقصى لرموز المخرجات؛
   • يعيد النتيجة ويسجّل عدد الرموز التي استُخدمت.
4. يستدعي الزر مسارك، لا المزوّد، ويعرض الملخص أثناء بثّه.
5. تعامل مع الفشل. إذا تأخر المزوّد أو أعاد خطأً، فاعرض «تعذّر التلخيص الآن» واجعل التذكرة قابلة للاستخدام.
6. قِس. بعد أسبوع، راجع سجلات الرموز. إذا كانت معظم التكلفة في سلاسل البريد الطويلة، فاقتطع السجل المقتبس قبل الإرسال.

لاحظ ما هو غائب: لا تدريب نموذج، ولا بنية تحتية خاصة. مفتاح واحد، ومسار خادم واحد، وطلب واحد مكتوب جيدًا.

مصطلحات أساسية

• مفتاح API: السر الذي يعرّف حسابك لدى المزوّد. أي شخص يملكه يستطيع إنفاق أموالك.
• النموذج (Model): نموذج LLM المحدد الذي تستدعيه. تقدّم المزوّدات عدة أحجام بأسعار وسرعات مختلفة.
• درجة الحرارة (Temperature): إعداد يحدد مدى تنوع الردود. كلما انخفض، كانت أكثر توقعًا.
• الحد الأقصى للرموز (Max tokens): سقف لطول الرد، وهو يحدّ من التكلفة أيضًا.
• حد المعدل (Rate limit): عدد الطلبات أو الرموز المسموح لحسابك بها في الدقيقة.
• التضمينات (Embeddings): أرقام تمثّل معنى النص، وتُستخدم في البحث داخل مستنداتك.
• RAG (التوليد المعزَّز بالاسترجاع): البحث عن مقاطع ذات صلة من بياناتك وإدراجها في الطلب، بحيث يجيب النموذج من محتواك.
• استخدام الأدوات / استدعاء الدوال (Tool use / function calling): أن يطلب النموذج من تطبيقك تشغيل دالة محددة، مثل «ابحث عن حالة الطلب».

أخطاء شائعة وسوء فهم

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

ماذا تطلب من أداة البناء

أضف زر «لخّص» في صفحة التذكرة. يستدعي مسارًا على الخادم يستخدم السر OPENAI_API_KEY (لا يُكشف أبدًا للمتصفح)، ويتحقق من أن المستخدم مسجّل الدخول، ويرسل نص التذكرة مع تعليمات النظام التالية: […]، ويقصر الرد على 300 رمز، ويبث الإجابة إلى الصفحة، ويعرض رسالة خطأ ودية إذا فشل الاستدعاء. سجّل عدد الرموز المستخدمة لكل طلب، وحدّد كل مستخدم بـ 30 ملخصًا في الساعة.

للحصول على تجربة دردشة كاملة، راجع كيف تبني تطبيق دردشة بالذكاء الاصطناعي؛ ولأفكار أخرى، كيف تضيف ميزات الذكاء الاصطناعي إلى تطبيقك. وإذا كانت واجهات API جديدة عليك، فابدأ بـما هي واجهة API.

واجهات LLM API في التطبيقات المبنية بـ Mythex

حين تبني بـ Mythex، يستخدم الذكاء الاصطناعي داخل تطبيقك مفتاح المزوّد الخاص بك. تضيفه كسر للمشروع، أو عبر بطاقة الأسرار التي يعرضها Mythex في الدردشة حين يحتاجه، وتطلب من الوكيل تنفيذ الاستدعاء على الخادم. تُحتسب تكلفة استخدام المزوّد على حسابك لدى المزوّد، لا على أرصدة بناء Mythex. لا يتضمن Mythex رموزًا لمستخدمي تطبيقك، ولا منتج قاعدة معرفة مدمجًا، وحدود المعدل وضوابط التكلفة من مسؤوليتك أنت تصميمها واختبارها. تتضمن وصفة الوثائق إضافة ميزات الذكاء الاصطناعي بمفاتيح API الخاصة بك موجّهًا جاهزًا للبدء، وتعرض صفحة منشئ تطبيقات الذكاء الاصطناعي أين تبدأ.

الأسئلة