حاسبة العبء الإضافي للمخرجات المنظمة
المدخلات
| عدد الحقول | 8 |
|---|---|
| الرموز لكل حقل | 8 |
| عدد الاستدعاءات | 1,000 |
| سعر المخرجات (لكل مليون رمز) | 3 $ |
| رموز الإطار | 4 |
حاسبة العبء الإضافي للمخرجات المنظمة
تقدير الرموز الإضافية في المخرجات وتكلفتها عند مطالبة نموذج لغوي بإرجاع JSON مطابق لمخطط — أسماء الحقول وعلامات الأنواع وعلامات الترقيم التي تحيط بالقيم الفعلية.
المدخلات
المخطط
الحجم والتسعير
رموز الإطار
النتائج
أدخل قيمة لعرض النتائج.
تفاصيل
العبء الإضافي للمخرجات المنظمة
العبء الإضافي للمخرجات المنظمة هو حصة استجابة النموذج اللغوي المكوّنة من التنسيق لا من المحتوى. عندما يُطلب من النموذج إرجاع JSON مطابق لمخطط، يجب أن يُصدِر كل اسم مفتاح وعلامة اقتباس ونقطتين رأسيتين وفاصلة وقوس إضافةً إلى القيم الفعلية. تُولَّد هذه الرموز البنيوية وتُحتسب تمامًا كأي رمز مخرجات آخر، فقد تنفق استجابة تحمل بضع قيم قصيرة جزءًا كبيرًا من رموزها على البنية المساعدة. تعزل هذه الحاسبة ذلك العبء الإضافي الثابت والتكلفة المتكررة التي يولّدها عبر حجم من الاستدعاءات.
مصدر العبء الإضافي
يسهم كل حقل في الكائن المُرجَع بمفتاح بين علامتي اقتباس، ونقطتين رأسيتين تفصلان
المفتاح عن القيمة، وفاصلة قبل الحقل التالي. ويتجزّأ حقل باسم shipping_status إلى
عدة أجزاء قبل كتابة أي قيمة. وفوق التكلفة لكل حقل، تحمل كل استجابة إطارًا ثابتًا —
قوسا فتح الكائن وإغلاقه وأي بنية مساعدة للمخطط يحقنها المزوّد — يُحسب مرة واحدة
بصرف النظر عن عدد الحقول التالية. ولأن هذا الإطار والبنية لكل حقل لا يعتمدان على
القيم، يكون العبء الإضافي ثابتًا لمخطط معيّن ويتنامى خطيًا مع عدد الاستدعاءات.
الصيغة
مع من الحقول بمعدل رمزًا من البنية المساعدة لكل منها و من رموز الإطار، يكون العبء الإضافي لكل استدعاء
tcall=f⋅tf+twعبر من الاستدعاءات، يكون إجمالي عدد الرموز البنيوية وتكلفته بسعر مخرجات لكل مليون رمز
TC=tcall⋅n=106Tpتحوّل القسمة على عرض السعر لكل مليون إلى معدل لكل رمز. تُولَّد المخرجات المنظمة بواسطة النموذج، فيُحتسب العبء الإضافي بسعر المخرجات، وهو عادةً الأعلى بين السعرين المنشورين.
مثال محلول
لنتأمّل مهمة استخراج تُرجِع سجلًا مكوّنًا من 12 حقلًا، حيث يكلّف كل حقل نحو 9 رموز من البنية المساعدة ويضيف إطار الكائن 5 من رموز الإطار. يكون العبء الإضافي لكل استدعاء
tcall=12×9+5=113 tokensعند التشغيل عبر 40,000 استدعاء بسعر مخرجات يبلغ $15 لكل مليون رمز، تكون التكلفة البنيوية
TC=113×40000=4,520,000 tokens=1064520000×15=$67.80هذه التكلفة البالغة $67.80 لا تشتري أي معلومة — فهي تدفع ثمن الأقواس والمفاتيح والفواصل التي تغلّف القيم المستخرجة فحسب. وعند هذا الحجم، يُترجَم اختصار أسماء المفاتيح أو إسقاط الحقول غير المستخدمة مباشرةً إلى توفير متكرر.
ملاحظات وتنويعات
القيمة لكل حقل متوسط؛ فأسماء المفاتيح الطويلة الوصفية تكلّف أكثر من المختصرة، وتضيف الكائنات المتداخلة أقواسها ومفاتيحها الوسيطة. ويُصدِر النموذج أيضًا القيم نفسها، وهو ما تستثنيه هذه الحاسبة — إذ تقيس الحد البنيوي الأدنى الذي يفرضه المخطط فقط. وحيثما أمكن تقديم المهمة نفسها بتمثيل أكثر اختصارًا، ينخفض ذلك الحد تبعًا لذلك.
التطبيق
يقع العبء الإضافي للمخرجات المنظمة على جانب المخرجات من الفاتورة. أما النظير على جانب المدخلات — تعريفات الأدوات المُرسَلة مع كل طلب استدعاء دوال — فتتناوله حاسبة العبء الإضافي للرموز في استدعاء الدوال. ولتسعير استهلاك الرموز الأساسي لكل استدعاء الذي تُشتقّ منه هذه الأعباء، انظر حاسبة تكلفة التوكنات.
الأسئلة الشائعة (FAQ)
ما هي المخرجات المنظمة؟
المخرجات المنظمة هي وضع يُقيَّد فيه النموذج بإرجاع البيانات بشكل ثابت — غالبًا JSON مطابق لمخطط مُعطى — بدلًا من نص حر. تُستخدم عندما يحلّل برنامج الاستجابة مباشرة، كاستخراج الحقول من مستند أو إرجاع سجل ذي أنواع محددة.
هذه البنية مريحة للشيفرة المستهلِكة لكنها مكوّنة من رموز في حد ذاتها: كل اسم مفتاح وعلامة اقتباس ونقطتين رأسيتين وفاصلة وقوس يُولَّد ويُحتسب إلى جانب القيم.
كيف يمكن خفض العبء الإضافي للمخطط؟
تكلّف أسماء المفاتيح الأقصر رموزًا أقل، فاسم الحقل المختصر يقلّص القيمة لكل حقل عبر كل استدعاء. ويتجنّب إرجاع الحقول التي تستخدمها خطوة لاحقة فعلًا فقط دفعَ ثمن بيانات لا يقرؤها شيء. كما يزيل تسطيح الكائنات المتداخلة بعمق الأقواس والمفاتيح الوسيطة.
ولأن العبء الإضافي ثابت لكل استجابة، يكون أكثر أهمية في الاستدعاءات كثيرة العدد صغيرة الحمولة حيث قد تنافس البنية المحتوى في الحجم.
هل يكلّف وضع JSON القدر نفسه الذي يكلّفه استدعاء الدوال؟
يفرض كلاهما عبئًا إضافيًا في الرموز، لكن في مواضع مختلفة. يضيف وضع JSON أو المخرجات المنظمة رموزًا إلى الاستجابة — الكائن الذي يكتبه النموذج. أما استدعاء الدوال فيرسل إضافةً إلى ذلك تعريفات الأدوات في المدخلات في كل استدعاء، فيقع عبؤه الإضافي على جانب المدخلات أساسًا.
تتناول حاسبة العبء الإضافي لاستدعاء الدوال تلك التكلفة على جانب المدخلات، بينما تتناول هذه الحاسبة التكلفة على جانب المخرجات للكائن المُرجَع.
إخلاء المسؤولية
أرقام الرموز تقديرات تعتمد على مُرمِّز النموذج وأسماء المفاتيح الدقيقة وكيفية تداخل المخطط. تتغير الأسعار المنشورة بمرور الوقت وقد تستثني خصومات التخزين المؤقت أو الدفعات. تحقّق من الأسعار الحالية وأعداد الرموز الدقيقة لدى مزوّدك قبل الاعتماد على أي رقم في الفوترة.