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