ما هي واجهة API للذكاء الاصطناعي؟ — دليل المبتدئ للأسعار والتوكنات واختيار النموذج والفرق عن دردشة الويب

«أنا أدفع 20 دولاراً شهرياً لـ ChatGPT — هل سيكون استدعاء API مباشرة أرخص؟» سؤال يطرحه مبتدئو الذكاء الاصطناعي كثيراً. الجواب المختصر: أحياناً نعم، وأحياناً العكس. الحدّ الفاصل يعتمد على «كم مرة تستدعي الذكاء الاصطناعي شهرياً» و«طول مدخلاتك».

على سبيل المثال، عشرة أسئلة قصيرة يومياً؟ ستكلفك API 1–2 دولار شهرياً. لكن تحليل مستند بـ 100 ألف توكن يومياً؟ تقفز فاتورة API إلى 50–200 دولار شهرياً. الرسم الثابت للدردشة عبر الويب آمن؛ وللاستخدام الخفيف تكون API أرخص بكثير — لكن إذا أخطأت في هذا الانعكاس، فستفاجأ بشكل مزعج في فاتورة نهاية الشهر.

دعني أُظهر رأيي مقدماً: «المطورون الذين يدمجون الذكاء الاصطناعي في تطبيقاتهم»، و«الأفراد الذين يرغبون في إلغاء اشتراك ChatGPT/Claude واستخدام الذكاء الاصطناعي بشكل خفيف»، و«الأشخاص الذين يرغبون في مقارنة عدة نماذج» — هذه الأنماط الثلاثة تستفيد بوضوح من API. وعلى العكس، إذا كنت «ترغب في الاحتفاظ بالمحادثات في واجهة الويب»، أو «تستخدم توليد الصور أو الإدخال الصوتي كثيراً»، أو «تكره النظر إلى الفواتير»، فالبقاء على اشتراك الدردشة عبر الويب هو الجواب الصحيح. تغطي هذه المقالة الفروق الأساسية بين الدردشة عبر الويب وAPI، وكيف تعمل التوكنات والأسعار، وأسعار مايو 2026 لواجهات API الرئيسية، وكيفية اختيار النموذج، والفخاخ الثلاثة للمبتدئين التي تصيب الجميع، وأول استدعاء — كل ذلك من منظور المبتدئ.

1. ChatGPT بـ 20 دولاراً شهرياً — قد تكون API بـ 2 دولار (أو العكس)

حساب ملموس. «عشرة أسئلة قصيرة يومياً.» كل استدعاء: 200 توكن إدخال + 200 توكن إخراج (حوالي 130–160 كلمة إنجليزية). مع Claude Sonnet 4.6 (إدخال 3 دولارات / إخراج 15 دولاراً لكل مليون توكن)، يكلف الاستدعاء الواحد 0.0036 دولار، شهرياً ~1.10 دولار. وهذا 1/18 من رسم ChatGPT Plus البالغ 20 دولاراً شهرياً.

الآن العكس. «تحليل مستند بـ 100 ألف توكن يومياً.» Claude Opus 4.7 (إدخال 5 دولارات / إخراج 25 دولاراً)، استدعاء واحد بـ 100 ألف إدخال + 5 آلاف إخراج = 0.625 دولار. ثلاثون استدعاءً/شهر = 18.75 دولاراً؛ ومئة = 62.50 دولاراً. GPT-5.5 من OpenAI يضاعف سعر الإدخال فوق 272 ألف توكن، لذا تقفز مهام السياق الطويل بشكل أصعب.

الحدّ التقريبي: «أقل من 200–300 استدعاء/شهر، API أرخص.» المستخدمون المكثفون (حركة يومية كبيرة، مدخلات طويلة) ينتهي بهم الأمر غالباً بشكل أفضل مع الرسم الثابت للدردشة عبر الويب. هذا هو التوتر الأساسي بين «الثابت» (دردشة الويب) و«الدفع حسب الاستخدام» (API).

2. الدردشة عبر الويب مقابل API — خمسة فروق ملموسة

إلى جانب التسعير، تختلف دردشة الويب وAPI اختلافاً جوهرياً في طريقة استخدامها. خمس نقاط:

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

أيضاً، API هي بشكل أساسي واجهة نصية. ميزات دردشة الويب مثل توليد الصور، والإدخال الصوتي، وCode Interpreter، وCanvas، وMemory إما لا توجد عبر API أو تعيش خلف نقاط نهاية منفصلة. يفترض الناس أن «80% من ميزات ChatGPT موجودة في API» لكنهم يدركون أنها أقرب إلى 50–60%.

3. ما هو التوكن؟ — أصغر وحدة تسعير

لفهم تسعير API، يجب أن تفهم «التوكنات». كل أسعار البائعين مكتوبة بصيغة «X دولاراً لكل مليون توكن».

4. أسعار واجهات API الرئيسية — Claude مقابل GPT مقابل Gemini

مايو 2026 أسعار API للنماذج الرئيسية (إدخال / إخراج، لكل مليون توكن). تغييرات الأسعار تحدث كل ثلاثة أشهر، لذا تحقق من أحدث الأسعار في صفحة التسعير الرسمية للبائع قبل اتخاذ القرار.

حتى الجدول وحده يُظهر: الإخراج يكلف 5–10 أضعاف الإدخال. كل استدعاء يولّد كليهما، لذا الاستخدامات كثيفة الإخراج (التلخيص، توليد المقالات، توليد الشفرة) تكلف أكثر. المهام خفيفة الإخراج (التصنيف، الإجابات القصيرة) تعمل بثمن رخيص جداً على API.

المهم بنفس القدر: «آليات الخصم»:

• التخزين المؤقت للموجهات (Anthropic / OpenAI): إعادة استخدام نفس موجه النظام وسعر الإدخال ينخفض حتى 90% من الاستدعاء الثاني
• Batch API (OpenAI / Google): دفعات غير متزامنة تُعالج خلال 24 ساعة، خصم 50%
• تكلفة كتابة الكاش: Anthropic تفرض 1.25x لكتابات الكاش؛ القراءات بـ 0.1x

تجاوز هذه الآليات وستدفع السعر الكامل بينما كان بإمكانك دفع 1/3 إلى 1/5. انظر توفير تكلفة توكنات وجلسات الذكاء الاصطناعي للمزيد.

5. اختيار النموذج — خريطة الأربعة استخدامات

«أي نموذج يجب أن أختار؟» هو السؤال الأكبر للمبتدئين. اعتباراً من مايو 2026، التقسيم إلى أربعة أنواع يبسّط القرار.

6. ثلاثة فخاخ تسعير يقع فيها كل مبتدئ

خلال 3 أشهر من البدء بواجهات API، يقع الجميع تقريباً في أحد ثلاثة فخاخ تسعير. ها هي.

الفخ ①: إعادة إرسال تاريخ المحادثة بالكامل في كل مرة

API لا تتذكر. لإنشاء سلوك «يبدو كدردشة»، يجب أن تعيد إرسال المحادثة الكاملة في كل استدعاء. اترك هذا دون إدارة وبحلول الدور العاشر تكون ترسل أكثر من 10,000 توكن إدخال لكل استدعاء. الحل: لخّص المحادثة القديمة قبل إعادة الإرسال، أو عامل تحولات الموضوع كجلسات جديدة.

الفخ ②: تضخيم موجه النظام

«أنت خبير في X.» «اتبع هذه القواعد العشرين.» «يجب أن يكون تنسيق الإخراج …» — مقدمة طويلة هي أمر كلاسيكي للمبتدئين. موجه نظام بـ 2,000 توكن يُستدعى 100 مرة يومياً يكلف 30 دولاراً شهرياً من ذلك وحده. فعّل التخزين المؤقت للموجهات وستنخفض الاستدعاءات الثانية وما بعدها بنسبة 90%. في الشفرة، غالباً ما يكون مجرد إضافة cache_control: { type: "ephemeral" } على كتلة واحدة.

الفخ ③: نسيان تعيين حدود الإنفاق / المعدل

أخطر نتيجة للمبتدئين: «خطأ يضع الشفرة في حلقة لا نهائية وفاتورة نهاية الشهر 500 دولار.» امنع ذلك بـ تعيين حد إنفاق لكل مفتاح (سقف صارم). كلاً من Anthropic Console وOpenAI Platform يسمحان بتحديد سقف للإنفاق الشهري؛ اضبطه عند إنشاء المفتاح. للمبتدئين، 20–50 دولاراً سقف آمن.

7. أول استدعاء API — curl وPython في 5 دقائق

بعيداً عن النظرية، إليك الشفرة الدنيا لإرسال «Hello» إلى Claude API من Anthropic.

الإعداد (3 خطوات)

1. أنشئ حساباً في Anthropic Console (أو platform.openai.com لـ OpenAI)
2. أصدر مفتاح API (القائمة اليسرى «API Keys» ← «Create Key»). يُعرض مرة واحدة فقط — احفظه الآن
3. في الإعدادات، عيّن حد إنفاق بحوالي 20 دولاراً (إلزامي للمبتدئين)

استدعاء curl الأدنى

curl https://api.anthropic.com/v1/messages \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 100,
    "messages": [
      {"role": "user", "content": "Hello from the AI API world"}
    ]
  }'

تستلم JSON. استجابة الذكاء الاصطناعي في content[0].text؛ التوكنات المستهلكة في usage.input_tokens وusage.output_tokens. «كم توكناً استهلك هذا فعلاً؟» — تلك الاستجابة تخبرك، في كل مرة.

Python (موصى به)

pip install anthropic

import os
from anthropic import Anthropic

client = Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"])

response = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=100,
    messages=[
        {"role": "user", "content": "Hello from the AI API world"}
    ]
)

print(response.content[0].text)
print(f"Used: input {response.usage.input_tokens} / output {response.usage.output_tokens}")

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

الخلاصة

مراجعة:

• دردشة الويب رسم ثابت، API دفع حسب الاستخدام. الاستخدام الخفيف (~10/يوم) يقع عند 1–2 دولار/شهر على API؛ الاستخدام المكثف قد يصل إلى 50–200 دولار/شهر
• خمسة فروق: الاستدعاء / الفوترة / الواجهة / الجلسة / الميزات. API لا تتذكر التاريخ، لذا تعيد إرساله بنفسك
• التوكنات هي وحدة التسعير. ~0.75 كلمة إنجليزية لكل توكن؛ الإخراج يكلف 5–10 أضعاف الإدخال
• أسعار مايو 2026: Sonnet 3/15 دولاراً، Opus 5/25 دولاراً، GPT-5.5 5/30 دولاراً، Gemini 3.1 Pro 2/12 دولاراً (لكل مليون توكن)
• استخدم خريطة نماذج بـ 4 أنواع (مميز / حصان عمل / خفيف / مفتوح). إقران ② حصان العمل + ③ خفيف هو الجواب العملي
• ثلاثة فخاخ تسعير: تراكم التاريخ / موجهات نظام ضخمة / غياب حدود الإنفاق. تعيين الحدود من اليوم الأول يمنع معظمها
• أول استدعاء: 5 دقائق بـ curl أو Python. لا ترفع المفاتيح إلى GitHub وعيّن حد إنفاق أولاً — هذا كل شيء

اشتراكات دردشة الويب مريحة، لكن في اللحظة التي تفكر فيها «أريد دمج الذكاء الاصطناعي في أداتي، أو الأتمتة، أو سير العمل»، تصبح API خياراً حقيقياً. تبدو مخيفة في البداية، لكن عيّن حد إنفاق منخفض، شغّلها مرة أو مرتين، واشعر أن كل استدعاء يكلف حوالي 0.01 دولار. عندما تأتي فاتورة نهاية الشهر بـ 1.50 دولار، ستتخطى بهدوء الخط الذي يتحول فيه الذكاء الاصطناعي من شيء «تستخدمه» إلى شيء «تبني به».

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