AR ▾
احصل على مفتاح API
دليل أسعار واجهة برمجة تطبيقات LLM بدون رقابة

كيف يعمل تسعير واجهة برمجة التطبيقات القائم على الرموز، مُشرَحًا ببساطة

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

تم التحديث

مكعبات صغيرة تتدفق إلى عداد ومكعبات أكبر تتدفق للخارج، تصور تسعير رموز الإدخال والإخراج
نقاط رئيسية
  • تدفع مقابل كل رمز، بسعر واحد للإدخال وسعر أعلى للإخراج.
  • يتم إعادة إرسال سجل المحادثة في كل خطوة، لذا فإن الدردشات الطويلة تكلف أكثر لكل رسالة من القصيرة.
  • حدود المعدل (rate limits) تقيد سرعة إرسال الطلبات (requests). ولا تغير السعر لكل رمز (token).
  • تفرض الـ API لدينا رسومًا بقيمة $0.15 و $0.50 لكل مليون رمز (token) من رصيد مسبق الدفع، وهي منتج منفصل عن أي مزود آخر.

النموذج في فقرة واحدة

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

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

الرموز (tokens) هي الوحدة

الرمز (token) هو قطعة نص يقرأها النموذج أو يكتبها. قد يكون كلمة قصيرة كاملة، أو جزءًا من كلمة طويلة، أو رقمًا أو علامة ترقيم. بالنسبة للنثر الإنجليزي العادي، فإن قاعدة الإبهام التقريبية هي أن الرمز (token) الواحد يساوي حوالي أربعة أحرف، أو ثلاثة أرباع الكلمة. اللغات الأخرى، والبرمجة، والتنسيقات غير المعتادة عادةً ما تستهلك رموزًا (tokens) أكثر لنفس الطول المرئي، لذا تعامل مع أي قاعدة إبهام كتقدير واقرأ الأعداد الحقيقية من الـ API.

تتضمن كل استجابة من الـ API لدينا كائن استخدام (usage object) يحتوي على prompt_tokens و completion_tokens. للاستجابات المتدفقة (streamed)، يصل الاستخدام في النهاية. هذان العددان هما ما تُحسب عليهما الرسوم. لا شيء آخر، مثل عدد الطلبات (requests) أو الوقت الذي استغرقته المكالمة، يدخل في السعر.

بما أن الوحدة هي الرموز (tokens) وليس الأحرف أو المكالمات، يمكن أن تكون الميزة نفسها رخيصة أو مكلفة اعتمادًا على كيفية بنائها. قد يكلف موجه (prompt) تصنيف من سطر واحد جزءًا صغيرًا من السنت لألف مكالمة. أما موجه (prompt) يلصق مستندًا مكونًا من 60 صفحة في كل طلب فيكلف أكثر بكثير، حتى لو تم استدعاؤه بنفس عدد المرات.

الإدخال والإخراج لهما أسعار مختلفة

رموز الإدخال (Input tokens) هي كل ما ترسله: رسالة النظام، سجل المحادثة، أحدث رسالة للمستخدم، تعريفات الأدوات ونتائج الأدوات. رموز الإخراج (Output tokens) هي ما يولده النموذج، بما في ذلك أي استدعاء أداة يكتبه. توليد النص يتطلب حسابات أكثر من قراءته، لذا فإن المزودين يسعرون الإخراج بشكل أعلى. على الـ API لدينا، الأسعار هي:

لكل 1M رمز (token)كل رمز
مدخل$0.15$0.00000015
مخرج$0.50$0.0000005

الإخراج هو 0.50 / 0.15، أو حوالي 3.3 مرة أكثر تكلفة لكل رمز (token). هذا النسب يقود قرارات التصميم. إذا كان تطبيقك يرسل موجه (prompt) مكونًا من 3,000 رمز (token) ويحصل على تصنيف مكون من 100 رمز (token)، فإن الإدخال يكلف $0.00045 والإخراج يكلف $0.00005، لذا فإن الموجه (prompt) يمثل 90 بالمائة من التكلفة، وتقصيره أهم من أي شيء آخر. إذا كان تطبيقك يطلب قصصًا مكونة من 2,000 رمز (token) من موجه (prompt) مكون من 200 رمز (token)، فإن الإدخال يكلف $0.00003 والإخراج يكلف $0.001، لذا فإن الإخراج يمثل 97 بالمائة من التكلفة، والمفتاح هو طول القصة.

تحقق من هذه الأرقام بنفسك: 3,000 x 0.15 / 1,000,000 = 0.00045. 100 x 0.50 / 1,000,000 = 0.00005. 200 x 0.15 / 1,000,000 = 0.00003. 2,000 x 0.50 / 1,000,000 = 0.001.

لماذا يجعل السجل المحادثات أكثر تكلفة مع مرور الوقت

الـ API عديم الحالة (stateless). النموذج لا يتذكر طلبك السابق، لذا فإن تطبيق الدردشة يعيد إرسال الرسائل السابقة مع كل رسالة جديدة. لذلك يحتوي الإدخال للدورة 10 على الدورات من 1 إلى 9 مرة أخرى، وتدفع مقابل هذه الرموز (tokens) في كل مرة.

خذ دردشة تضيف فيها كل خطوة 400 رمز (token) في المجموع. الدورة 1 ترسل حوالي 400 رمز (token) من السياق، الدورة 10 حوالي 4,000 والدورة 50 حوالي 20,000. نافذة السياق (context window) للنموذج على الـ API لدينا هي 100,000 رمز (token)، للإدخال والإخراج معًا، لذا فإن جلسة طويلة جدًا ستحتاج في النهاية إلى التقصير بغض النظر عما إذا كانت التكلفة مهمة أم لا. الحلول الشائعة هي:

  • احتفظ بموجه (prompt) النظام وآخر N خطوات، وتخلص من المنتصف.
  • لخص الخطوات القديمة في ملاحظة قصيرة وأرسل الملاحظة بدلاً منها.
  • احفظ الحقائق طويلة المدى خارج الدردشة وأدرج فقط تلك ذات الصلة.

رقم ملموس: توجيه نظام مكون من 1,000 رمز يُرسل مع كل طلب من 1,000 طلب ينتج 1,000,000 رمز مدخل، أي $0.15. مبلغ ضئيل بمفرده. لكن ورقة شخصية مكونة من 10,000 رمز تُرسل مع كل طلب من 100,000 طلب تنتج 1,000,000,000 رمز مدخل، أي $150. يتضاعف الحمل الثابت مع الحجم، وهذا الضرب هو ما يجب مراقبته.

رصيد مسبق الدفع، وليس اشتراكًا

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

شحن الرصيد يكون بمبالغ صحيحة من $20 إلى $500، مع مكافأة +5% من $50، و+10% من $100، و+15% من $200. لذا فإن $100 تمنحك $110 من الرصيد، و$200 تمنحك $230. يمكنك الدفع بالعملات المشفرة (USDT على TRC20، USDC على Base). النتيجة العملية هي أن أسوأ حالة تكون مقيدة بما قمت بتحميله: خطأ في الحلقة لا يمكنه إنفاق أكثر من الرصيد المتاح. الرصيد بعد كل استدعاء يظهر في رأس الاستجابة X-Balance-USD.

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

حدّ المعدل مقود منفصل

يمكن لواجهات برمجية ذات السعر نفسه لكل مليون رمز أن تبدو مختلفة جدًا، لأن حدود المعدل تحدد مقدار ما يمكنك إرساله في الدقيقة. عادةً ما يضع المزودون حدودًا لكل فئة حساب. في الواجهة البرمجية لدينا، المفتاح الكامل يسمح بـ 8 طلبات متزامنة و300 طلب في الدقيقة، بينما يسمح المفتاح التجريبي بـ 2 طلب متزامن و60 طلب في الدقيقة. الحد الأقصى لحجم الجسم هو 8 MB.

عند تجاوز الحد، تحصل على HTTP 429. رمز الخطأ هو rate_limited عندما تتجاوز طلبات في الدقيقة، وconcurrency عندما يكون هناك طلبات كثيرة قيد التنفيذ. في حالات الحمل الزائد المؤقت، تعيد الواجهة البرمجية أيضًا 429 مع رأس Retry-After: 5. نقطة واحدة تلتقط انتباه الناس: الطلب المتدفق يحتفظ بمكان التزامن حتى ينتهي البث، لذا فإن العملاء البطيئين الذين يقرأون الرموز واحدًا تلو الآخر يمكنهم ملء الـ 8 أماكن أسرع مما يشير إليه عدد الطلبات.

تؤثر الحدود على السعة، وليس السعر. إذا كنت بحاجة إلى إرسال دفعة كبيرة، فإن الحساب بسيط: عند 300 طلب في الدقيقة، يستغرق 10,000 طلب حوالي 34 دقيقة، بافتراض أن كل طلب ينتهي بسرعة كافية للبقاء ضمن 8 طلبات في الوقت نفسه.

تطبيق النموذج على واجهة برمجة التطبيقات هذه

الجزء المتوافق مع OpenAI هو ما يجعل نموذج التسعير قابلاً للنقل. أي حزمة تطوير برمجية لـ OpenAI تعمل بمجرد تغيير عنوان URL الأساسي والمفتاح، لذا يمكن عادةً إعادة استخدام كود تتبع التكلفة الذي كتبته لمزود آخر. هذا النص البرمجي يقرأ الاستخدام ويقيم تكلفة الاستدعاء بأسعارنا:

from openai import OpenAI

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

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a concise assistant."},
        {"role": "user", "content": "Explain what a token is in two sentences."},
    ],
)

u = resp.usage
input_cost = u.prompt_tokens * 0.15 / 1_000_000
output_cost = u.completion_tokens * 0.50 / 1_000_000
print(f"in={u.prompt_tokens} out={u.completion_tokens} total={input_cost + output_cost:.7f}")

ما هو هذا الـ API، بالمصطلحات أعلاه: نموذج واحد، للنصوص فقط، نافذة سياق مكونة من 100,000 رمز، استدعاء الدوال، وضع JSON والبث المتدفق، وموجّهات لا تُستخدم للتدريب. النموذج مُضبط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين، وهناك حد صارم على المحتوى الجنسي الذي يتضمن القاصرين. ليس موزعاً عبر موردين وليس نقطة النهاية الرسمية لأي مورد. تفاصيل الإعداد موجودة في الدليل السريع، وقائمة الأسعار الكاملة موجودة في صفحة التسعير. لمقارنة عملية مع خدمات أخرى، انظر صفحة تكلفة واجهة برمجة تطبيقات ChatGPT.

أسئلة وأجوبة

ماذا يعني نموذج تسعير واجهة برمجة تطبيقات OpenAI بالمصطلحات البسيطة؟

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

هل الإدخال أو الإخراج أكثر تكلفة؟

الإخراج. في الـ API الخاص بنا هو $0.50 لكل مليون رمز مقابل $0.15 لكل مليون للإدخال، أي حوالي 3.3 مرة أكثر.

لماذا يكلف الدردشة الطويلة أكثر لكل رسالة؟

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

هل حدّ المعدل يغير ما أدفعه؟

لا. فهي تحد من عدد الطلبات في الدقيقة والطلبات المتزامنة. يظل السعر لكل رمز كما هو.

هل واجهة برمجة التطبيقات الخاصة بكم هي نفسها الخاصة بـ OpenAI؟

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

مفتاحك على بُعد نموذج واحد

أنشئ حساباً، وانسخ المفتاح، ثم غيّر عنوان URL الأساسي. هذا هو الإعداد الكامل.