رموز الإدخال مقابل الإخراج: ما تدفع مقابله API الذكاء الاصطناعي

إذا كنت قد أجريت للتو أول استدعاء API لنموذج لغوي، فمن المحتمل أنك رأيت كتلة usage في الاستجابة وتساءلت عما تحسبه بالضبط. الإجابة المختصرة: كل طلب له مقياسان. أحدهما يحسب الرموز التي ترسلها (الإدخال)، والآخر يحسب الرموز التي يكتبها النموذج ردًا (الإخراج). لكل مقياس سعره الخاص، وتكلفة الطلب هي مجموع الاثنين.

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

ما يُحسب كإدخال وما يُحسب كإخراج#

رموز الإدخال هي كل ما يجب على النموذج قراءته للإجابة عليك:

• رسالتك الأخيرة؛
• موجه النظام (تعليمات مثل "أجب بإيجاز، باللغة الإنجليزية")؛
• الرسائل السابقة في المحادثة، إذا أعدت إرسالها؛
• المستندات أو التعليمات البرمجية أو نتائج البحث التي تلصقها في الطلب.

رموز الإخراج هي كل ما يولده النموذج في الرد. في التنسيق المتوافق مع OpenAI، هذا هو النص في choices[0].message.content. بعض النماذج في وضع التفكير تولد أيضًا رموز استدلال قبل الإجابة النهائية؛ تحقق من صفحة تسعير النموذج لمعرفة ما إذا كانت تُحسب كإخراج.

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

أين تقرأ الأرقام: كتلة الاستخدام#

كل استجابة غير متدفقة من API متوافق مع OpenAI تنتهي بكائن usage. هذا مثال تعليمي لشكله:

{
  "choices": [
    { "message": { "role": "assistant", "content": "..." }, "finish_reason": "stop" }
  ],
  "usage": {
    "prompt_tokens": 2000,
    "completion_tokens": 500,
    "total_tokens": 2500
  }
}

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

تضيف بعض المزودين حقولًا إضافية. على سبيل المثال، API الخاص بـ DeepSeek يقسم أيضًا prompt_tokens إلى prompt_cache_hit_tokens وprompt_cache_miss_tokens، وفي وضع التفكير، يبلغ عن reasoning_tokens (المصدر: وثائق DeepSeek API، تم التحقق في 21 أكتوبر 2026). الحقول الثلاثة في الجدول هي التي يمكنك الاعتماد عليها في أي استجابة متوافقة مع OpenAI.

عند بث الإجابة، لا يكون الاستخدام معروفًا في البداية. في API الخاص بـ DeepSeek، يصل في آخر جزء محتوى قبل data: [DONE] (وثائق DeepSeek API، تم التحقق في 21 أكتوبر 2026)؛ قد ترسله واجهات API الأخرى بشكل مختلف أو عند الطلب فقط، لذا تحقق مما يستقبله عميلك. البث نفسه مشمول في استجابات البث في Python.

لماذا للجانبين أسعار مختلفة#

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

النموذج الذي نستخدمه كمثال أدناه، MiniMax-M2.7 (المعرف minimax-m2.7)، يتبع هذا النمط. الأسعار الحالية لكل مليون رمز هي $0.05 للإدخال و$0.15 للإخراج.

الصيغة#

تُقتبس الأسعار لكل مليون رمز، لذا تكلفة طلب واحد هي:

cost = input_tokens × input_price ÷ 1,000,000
     + output_tokens × output_price ÷ 1,000,000

إليك الصيغة بأسعار مستديرة مختلقة، فقط لإظهار الحساب (مثال، استبدل الأسعار الحالية من الجدول أدناه):

# example, substitute current prices from the table
price_in = 0.20    # USD per 1M input tokens
price_out = 0.80   # USD per 1M output tokens

prompt_tokens = 2000
completion_tokens = 500

cost = (prompt_tokens * price_in + completion_tokens * price_out) / 1_000_000
# 2000 × 0.20 ÷ 1,000,000 = 0.0004 (input)
# 500 × 0.80 ÷ 1,000,000 = 0.0004 (output)
# 0.0004 + 0.0004 = 0.0008 USD

مثال عملي مع نموذج حقيقي#

خذ الطلب من مثال usage أعلاه: 2,000 رمز إدخال و500 رمز إخراج. على MiniMax-M2.7 عبر CheapTokens يكلف $0.00018. يُحسب الرقم من قائمة الأسعار الحالية في كل مرة تُعرض فيها الصفحة.

طلب واحد صغير جدًا، لذا يساعد التوسيع. تطبيق صغير يرسل 10,000 طلب بهذا الحجم يستخدم 20,000,000 رمز إدخال و5,000,000 رمز إخراج، مما يصل إلى $1.75.

نفس الطلب على نماذج أخرى من قائمتنا:

لاحظ أن الإخراج جزء صغير من عدد الرموز هنا (500 من 2,500) لكنه جزء أكبر من الفاتورة من حصته من الرموز، لأن رموز الإخراج مسعرة أعلى (انظر الجدول). لهذا النموذج، جانب الإخراج هو أيضًا حيث يتأكد التوفير مقابل سعر OpenRouter المرجعي، وهو مفيد إذا كان تطبيقك يكتب إجابات طويلة.

استخدامه في الكود#

يمكنك قراءة usage من حزمة openai الرسمية لـ Python بتوجيهها إلى عنوان URL الأساسي لـ CheapTokens:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key="YOUR_API_KEY",
)

response = client.chat.completions.create(
    model="MiniMaxAI/MiniMax-M2.7",
    messages=[{"role": "user", "content": "Explain input and output tokens in two sentences."}],
)

usage = response.usage
print("input:", usage.prompt_tokens)
print("output:", usage.completion_tokens)
print("total:", usage.total_tokens)

# example, substitute current prices from the table above
price_in, price_out = 0.20, 0.80
cost = (usage.prompt_tokens * price_in + usage.completion_tokens * price_out) / 1_000_000
print(f"approx. cost: ${cost:.6f}")

إذا لم ترسل طلبًا بعد، فاتبع أول طلب API لك مع CheapTokens أولاً.

كيف تنفق رموزًا أقل#

• قصّر الموجه. قلّم موجه النظام وأزل التعليمات التي لا يحتاجها النموذج. كل رمز ترسله يُحسب في كل طلب.
• قلّم السجل. في محادثة طويلة، احتفظ بالدورات القليلة الأخيرة أو بملخص قصير بدلاً من المحادثة بأكملها.
• أرسل الجزء ذي الصلة فقط من المستند. صفحة نصية أرخص من ملف كامل.
• اطلب التنسيق الذي تحتاجه. "أجب في ثلاث نقاط" ينتج رموز إخراج أقل من مقال مفتوح.
• اضبط max_tokens عن قصد. يحد من الإخراج فقط. إذا كان منخفضًا جدًا، تُقطع الإجابة؛ التفاصيل في لماذا تتوقف إجابة الذكاء الاصطناعي في منتصف الجملة؟ يسمح MiniMax-M2.7 على CheapTokens بما يصل إلى 8,192 رمز إخراج لكل إجابة ولديه نافذة سياق 180K.

لتقدير تكلفة سير عمل أكبر، انظر كيف تقدر تكلفة وكيل ذكاء اصطناعي.

ما يجب تذكره#

1. كل طلب له رموز إدخال (prompt_tokens) ورموز إخراج (completion_tokens).
2. لهما أسعار منفصلة، عادةً مع إخراج أعلى.
3. التكلفة = رموز الإدخال × سعر الإدخال + رموز الإخراج × سعر الإخراج، مع أسعار لكل مليون رمز.
4. اقرأ الأرقام من usage في الاستجابة بدلاً من التخمين.

على CheapTokens، رصيد واحد مدفوع مسبقًا يغطي جميع النماذج، وأسعار كل نموذج ثابتة بدون تسعير ساعات الذروة، وAPI متوافق مع OpenAI Chat Completions وAnthropic Messages. لتجربة المثال أعلاه، احصل على مفتاح API وأرسل طلبك الأول.

الأسعار الحالية لكل نموذج: تسعير CheapTokens.