نظرة عامة
يمكنك مراجعة استخدام API بطريقتين:
استخدم لوحة معلومات الاستخدام لمراجعة النشاط خلال فترات الفوترة الحالية والسابقة.
اقرأ معلومات الاستخدام في استجابة API للتحقق من طلب بعينه.
يستخدم Playground استدعاءات API نفسها التي تستخدمها تطبيقاتك. تُحتسب رموزه ضمن استخدام API في حسابك، وتخضع لقواعد الاستخدام والأسعار نفسها.
الوصول إلى لوحة المعلومات
يجب أن تكون مالكًا للمؤسسة أو أن تكون لديك صلاحية لوحة معلومات الاستخدام للوصول إليها.
مراجعة الاستخدام في لوحة المعلومات
افتح لوحة معلومات الاستخدام، وحدد المؤسسة التي تريد مراجعتها، ثم اختر فترة إعداد التقارير المناسبة.
تُعرض بيانات لوحة المعلومات بالتوقيت العالمي المنسق (UTC). ضع هذه المنطقة الزمنية في الحسبان عند مقارنة نشاط لوحة المعلومات بسجلات تطبيقك.
تحديد المشاريع
تتضمن لوحة المعلومات أداة خاصة بها لاختيار المشاريع. تعمل هذه الأداة بشكل مستقل عن المشروع المحدد في مواضع أخرى من منصّة الـ API.
استخدم أداة الاختيار في لوحة المعلومات لمراجعة مشروع واحد أو عدة مشاريع أو جميع المشاريع. لعرض بيانات المؤسسة الإجمالية، ألغِ تحديد المشاريع. عند عدم تحديد أي مشروع، تعرض لوحة المعلومات بيانات جميع المشاريع.
مراجعة استخدام مستخدم بعينه
لمراجعة استخدام مستخدم واحد لواجهتَي Responses وإكمالات المحادثات:
في لوحة معلومات الاستخدام، انتقل إلى إمكانات API > Responses وإكمالات المحادثات.
حدد تصفية حسب.
ضمن المستخدمون، حدد المستخدم، ثم حدد تطبيق عوامل التصفية.
عرض الرموز في الدقيقة
تدعم صفحات تفاصيل الاستخدام تحديد الفاصل الزمني. حدد فاصلًا زمنيًا مدته دقيقة واحدة لفحص الرموز في الدقيقة (TPM).
ينطبق هذا الفاصل الزمني على بيانات الاستخدام، لا بيانات الفوترة.
تصدير بيانات الاستخدام
لا يوجد حد للنطاق الزمني للتصدير. قد تُقسَّم عمليات التصدير التي تغطي فترة طويلة إلى ملفات متعددة.
لمطابقة الفاتورة الشهرية وتصدير بنودها، راجع: تصدير تفاصيل الاستخدام الشهرية.
عرض منح رصيد الاستخدام
تتوفر تفاصيل منح رصيد الاستخدام في صفحة الفوترة الخاصة بمؤسستك.
تجيب منح رصيد الاستخدام وبيانات استخدام API عن سؤالين مختلفين: تعرض المنح رصيد الاستخدام المرتبط بمؤسستك، بينما تعرض بيانات الاستخدام نشاطها على API.
مراجعة استخدام مستوى السعة وتكاليفه
إذا كان مستوى السعة مفعّلًا لمؤسستك وكانت لديك صلاحية الوصول المطلوبة، فافتح صفحة استخدام مستوى السعة للاطلاع على تفاصيل الاستخدام.
تُحتسب تكاليف حِزم مستوى السعة على المؤسسة، لا على المشاريع الفردية.
الاستخدام أكبر من صفر، لكن إنفاق المشروع يساوي صفرًا
تحقق مما إذا كان استخدام النموذج مشمولًا ضمن مخصصات مستوى السعة. إذا كان استخدام ذلك النموذج كله ضمن مخصصات الرموز في الدقيقة (TPM) لمستوى السعة، فقد يظهر استخدام في المشروع من دون إنفاق إضافي على النموذج.
تظل تكلفة اشتراك مستوى السعة محسوبة على مستوى المؤسسة. لمراجعتها:
امسح عامل تصفية المشروع في لوحة معلومات الاستخدام.
حدد فئات الإنفاق.
مراجعة مؤسسات متعددة
لا تجمع لوحة معلومات الاستخدام بيانات التكلفة أو الاستخدام بين المؤسسات. تُعامل كل مؤسسة، بما فيها المؤسسة الفرعية، بشكل منفصل.
لعرض مؤسسة فرعية، حددها في أداة اختيار المؤسسة.
إذا كنت بحاجة إلى تقارير موحّدة، ففكّر في استخدام مشاريع ضمن مؤسسة واحدة بدلًا من مؤسسات فرعية منفصلة، أو استخدم واجهة برمجة تطبيقات الاستخدام لإجراء تحليل مخصص.
التحقق من استخدام الرموز في استجابة واجهة برمجة التطبيقات
تختلف أسماء حقول استخدام الرموز بحسب نقطة النهاية.
| عدد الرموز | إكمال المحادثات | الاستجابات |
|---|---|---|
| رموز الإدخال | usage.prompt_tokens | usage.input_tokens |
| رموز الإخراج | usage.completion_tokens | usage.output_tokens |
| إجمالي الرموز | usage.total_tokens | usage.total_tokens |
على سبيل المثال، قد تتضمن استجابة إكمال المحادثات ما يلي:
{
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
}
}بحسب نقطة النهاية والنموذج، قد تتضمن تفاصيل الاستخدام أيضًا أعداد رموز الإدخال المخزّنة مؤقتًا ورموز الاستدلال. تساعد هذه التفاصيل على توضيح سبب عدم تعبير طول الاستجابة الظاهر عن كامل استخدامها للرموز.
للاطلاع على شرح لفئات الرموز المختلفة، راجع: فهم الرموز وحساب عددها.
الحصول على بيانات الاستخدام من استجابات إكمال المحادثات المتدفقة
لطلب إكمال محادثات مع تفعيل التدفق، أدرج ما يلي:
{
"stream": true,
"stream_options": {
"include_usage": true
}
}عند تفعيل include_usage، تتضمن قطعة إضافية تسبق data: [DONE] بيانات الاستخدام للطلب بأكمله. تكون مصفوفة choices في هذه القطعة فارغة. تكون قيمة usage في القطع الأخرى هي null.
إذا انقطع التدفق، فقد لا تتلقى القطعة الأخيرة التي تتضمن بيانات الاستخدام. عدم وصول القطعة الأخيرة لا يثبت أن الطلب لم يستخدم أي رموز.
هذا الإعداد خاص بإكمال المحادثات. للتفاصيل، راجع: مرجع واجهة برمجة تطبيقات إكمال المحادثات.