كيفية حساب استخدام رموز API في 2026: إلى أي مدى ستكفيك ميزانيتك

تودع المال في حساب API، وسرعان ما يطرأ عليك السؤال: كم من الوقت سيكفي؟ لديك فكرة من قبيل «لديّ عشرة آلاف، وتكلفة المدخلات كذا، والمخرجات أغلى، وهناك نوع من الخصم على التخزين المؤقت أيضًا»، لكنك لا تعرف كيف تحوّل كل ذلك إلى رقم واحد. سأشرح الأمر خطوة بخطوة، بالأرقام.

الخلاصة أولًا: تُحسب فاتورة API باستخدام معادلة واحدة، وهي عدد الرموز مضروبًا في سعر الرمز. تُحسب رموز المدخلات والمخرجات كلٌّ على حدة لأن أسعارها مختلفة. سأوضح بعد ذلك كيف تستخدم هذه المعادلة لمعرفة المدة التي ستكفيك فيها ميزانيتك، وكيف يدخل التخزين المؤقت في الحساب.

تجد معلومات استخدام Ailoot في الوثائق.

ممَّ تتكوّن فاتورة API؟#

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

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

أسعار المدخلات والمخرجات مختلفة، لذا تُحسب منفصلة. معادلة الطلب الواحد بسيطة:

cost = (input tokens × input price) + (output tokens × output price)

تُعرض الأسعار عادةً لكل مليون رمز، وهذا أسهل لأن تكلفة الرمز الواحد جزء من الوحدة النقدية. تدور جميع الحسابات من الآن فصاعدًا حول هذه المعادلة، وتغطي ميزانيتك عدد الطلبات التي تسمح به أموالك المتاحة وفقًا لذلك السعر.

الرمز ليس كلمة: كيف تقدّر عدد الرموز التي ستستخدمها؟#

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

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

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

لماذا تكلف المخرجات أكثر من المدخلات، وما أثر ذلك على فاتورتك؟#

إليك جدول الأسعار الرسمية لكل مليون رمز في أوائل سبتمبر 2026؛ وتلاحظ أن تكلفة المخرجات تزيد عدة مرات على تكلفة المدخلات في جميع الحالات.

الفارق في الأسعار بين المزوّدين هائل: تكلفة مليون رمز إدخال في Claude Opus 5 تعادل نحو 7.58 مليون في DeepSeek Pro وفق أسعار الإدخال في الجدول ($5 ÷ $0.66 ≈ 7.58). لكن هناك قاعدة واحدة ضمن كل فئة سعرية: تكلفة المخرجات تزيد من ثلاثة إلى ستة أضعاف تكلفة المدخلات. والسبب بسيط: قراءة النموذج لطلبك أسهل من كتابة رد، والعمل الأصعب يكلف أكثر.

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

كيف تحسب المدة التي ستكفيك فيها ميزانيتك؟#

لنحسبها خطوة بخطوة. أدخل أسعارك وحجم الرموز المعتاد وميزانيتك.

1. قدّر طلبًا معتادًا. لنفترض أن استدعاءً واحدًا يستخدم 20,000 رمز إدخال (السؤال مع جزء من الشيفرة وبعض سجل المحادثة) و2,000 رمز إخراج (رد النموذج).
2. احسب تكلفة المدخلات: اقسم عدد رموز المدخلات على مليون، ثم اضرب الناتج في سعر المدخلات لكل مليون رمز.
3. احسب تكلفة المخرجات: اقسم عدد رموز المخرجات على مليون، ثم اضرب الناتج في سعر المخرجات لكل مليون رمز.
4. اجمع تكلفة المدخلات وتكلفة المخرجات.
5. اقسم ميزانيتك على تكلفة الطلب الناتجة.

باستخدام أسعار Opus 5 في جدول المقال: 20,000 ÷ 1,000,000 × $5 = $0.10 للإدخال، و2,000 ÷ 1,000,000 × $25 = $0.05 للإخراج. الإجمالي $0.15 لكل طلب دون تخزين مؤقت. تغطي ميزانية $10 عدد 66 طلبًا كاملًا ($9.90)، بافتراض أعداد الرموز نفسها وعدم وجود رسوم أخرى.

نادراً ما يكون الطلب الحقيقي «متوسطًا»: أرفق ملفًا كبيرًا أو أطل المحادثة، فترتفع المدخلات من 20,000 رمز إلى 200,000. لذا احسب بناءً على طريقتك المعتادة في العمل؛ فالطلب المثالي الافتراضي سيعطيك نتيجة خاطئة. ومن الأفضل أيضًا التقريب إلى الأعلى.

يستخدم Devin وClaude Code وأي وكيل ذكاء اصطناعي آخر API نفسه، ويستهلك الرموز وفق المعادلة نفسها؛ والفرق الوحيد أن الوكيل يستخدم رموزًا أكثر لأنه يجري استدعاءات عديدة في الخلفية. وقد شرحت على نحو منفصل سبب ارتفاع تكلفة البرمجة بأسلوب vibe coding عما هو متوقع في مقال التكلفة الخفية للبرمجة بأسلوب vibe coding.

ما خصم التخزين المؤقت، ومتى يُطبّق؟#

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

يعتمد مقدار الانخفاض على المزوّد. في Claude، تكلف إعادة القراءة من التخزين المؤقت أقل بعشر مرات من المدخلات العادية: فالمدخلات العادية في Opus 5 تكلف $5 لكل مليون، بينما تكلف القراءة من التخزين المؤقت $0.50. وخصم DeepSeek أكبر: فالمدخلات المخزنة مؤقتًا لنموذج flash تكلف $0.007 مقابل $0.22 للمدخلات العادية، أي أقل بأكثر من ثلاثين مرة. لذا فإن عبارة «خصم يصل إلى 80 بالمئة» تقدير متحفظ؛ وقد يكون الخصم الفعلي أكبر.

ضع شرطين في الحسبان، وإلا فسيكون حسابك للتخزين المؤقت غير دقيق.

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

كيف تعيد حساب ميزانيتك مع أخذ التخزين المؤقت في الحسبان؟#

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

خذ الطلب نفسه بـ20,000 رمز إدخال و2,000 رمز إخراج. ليكن 15,000 من الإدخال سياقًا ثابتًا و5,000 جديدة. استخدم أسعار Opus 5 المذكورة أعلاه: $5 لكل مليون إدخال جديد، و$0.50 لكل مليون قراءة ذاكرة مؤقتة، و$6.25 لكل مليون كتابة قصيرة الأمد (1.25 × $5)، و$25 لكل مليون إخراج.

الطلب المتكرر أرخص 45% من طلب $0.15 دون تخزين، رغم أن جزء الإدخال المخزن أرخص 90%. أما الكتابة الأولى فأغلى. يكلف استدعاءان، كتابة ثم إصابة، $0.25125 بدل $0.30. بميزانية $10، تعطي كتابة واحدة تليها 119 إصابة موثقة 120 استدعاء مقابل $9.98625. يفترض ذلك بقاء التخزين صالحًا وأعداد الرموز نفسها وعدم وجود رسوم أخرى؛ استخدم قياسات القراءة والكتابة الفعلية بدل افتراض إصابة كل تكرار.

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

أين تُستهلك الرموز من دون أن تلاحظ؟#

غالبًا ما تكون الفواتير أعلى مما توقعت، ويعود السبب دائمًا تقريبًا إلى ثلاثة أمور لا يمكنك ملاحظتها من النظرة الأولى.

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

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

والثالث هو المرفقات الكبيرة. إذا أرفقت مستندًا كبيرًا أو مجموعة ملفات بطلب، فستُرسل كاملةً ضمن المدخلات في كل استدعاء ما دامت موجودة في السياق. إذا كنت تعمل على المستند نفسه مدةً من الوقت، فمن المفيد الاحتفاظ به في التخزين المؤقت كيلا تواصل دفع السعر الكامل مقابل معالجته. وتُسمى إدارة ما يبقى في السياق مهارةً مستقلة هي هندسة السياق (context engineering)، وهي تؤثر مباشرةً على فاتورتك.

كيف تتابع الإنفاق من دون إجراء الحسابات يدويًا؟#

لا تحتاج إلى التقدير يدويًا إلا مرة واحدة، لتفهم عمومًا المدة التي ستكفيك فيها أموالك. بعد ذلك، لن تحتاج إلى الحساب يدويًا؛ فـ API يتولاه عنك.

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

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

تعرّف على Ailoot.