نظرة عامة
يمكنك مراجعة استخدام API بطريقتين:
استخدم لوحة معلومات الاستخدام لمراجعة النشاط خلال فترات الفوترة الحالية والسابقة.
اقرأ معلومات الاستخدام في استجابة API للتحقق من طلب بعينه.
يستخدم Playground استدعاءات API نفسها التي تستخدمها تطبيقاتك. تُحتسب رموزه ضمن استخدام API في حسابك، وتخضع لقواعد الاستخدام والأسعار نفسها.
الوصول إلى لوحة المعلومات
يجب أن تكون مالكًا للمؤسسة أو أن تكون لديك صلاحية لوحة معلومات الاستخدام للوصول إليها.
مراجعة الاستخدام في لوحة المعلومات
افتح لوحة معلومات الاستخدام، وحدد المؤسسة التي تريد مراجعتها، ثم اختر فترة إعداد التقارير المناسبة.
تُعرض بيانات لوحة المعلومات بالتوقيت العالمي المنسق (UTC). ضع هذه المنطقة الزمنية في الحسبان عند مقارنة نشاط لوحة المعلومات بسجلات تطبيقك.
تحديد المشاريع
تتضمن لوحة المعلومات أداة خاصة بها لاختيار المشاريع. تعمل هذه الأداة بشكل مستقل عن المشروع المحدد في مواضع أخرى من منصّة الـ API.
استخدم أداة الاختيار في لوحة المعلومات لمراجعة مشروع واحد أو عدة مشاريع أو جميع المشاريع. لعرض بيانات المؤسسة الإجمالية، ألغِ تحديد المشاريع. عند عدم تحديد أي مشروع، تعرض لوحة المعلومات بيانات جميع المشاريع.
مراجعة استخدام مستخدم بعينه
لمراجعة استخدام مستخدم واحد لواجهتَي Responses وإكمالات المحادثات:
في لوحة معلومات الاستخدام، انتقل إلى إمكانات API > Responses وإكمالات المحادثات.
حدد تصفية حسب.
ضمن المستخدمون، حدد المستخدم، ثم حدد تطبيق عوامل التصفية.
عرض الرموز في الدقيقة
تدعم صفحات تفاصيل الاستخدام تحديد الفاصل الزمني. حدد فاصلًا زمنيًا مدته دقيقة واحدة لفحص الرموز في الدقيقة (TPM).
ينطبق هذا الفاصل الزمني على بيانات الاستخدام، لا بيانات الفوترة.
تصدير بيانات الاستخدام
لا يوجد حد للنطاق الزمني للتصدير. قد تُقسَّم عمليات التصدير التي تغطي فترة طويلة إلى ملفات متعددة.
لمطابقة الفاتورة الشهرية وتصدير بنودها، راجع: تصدير تفاصيل الاستخدام الشهرية.
عرض منح رصيد الاستخدام
تتوفر تفاصيل منح رصيد الاستخدام في صفحة الفوترة الخاصة بمؤسستك.
تجيب منح رصيد الاستخدام وبيانات استخدام API عن سؤالين مختلفين: تعرض المنح رصيد الاستخدام المرتبط بمؤسستك، بينما تعرض بيانات الاستخدام نشاطها على API.
مراجعة استخدام مستوى السعة وتكاليفه
إذا كان مستوى السعة مفعّلًا لمؤسستك وكانت لديك صلاحية الوصول المطلوبة، فافتح صفحة استخدام مستوى السعة للاطلاع على تفاصيل الاستخدام.
تُحتسب تكاليف حِزم مستوى السعة على المؤسسة، لا على المشاريع الفردية.
الاستخدام أكبر من صفر، لكن إنفاق المشروع يساوي صفرًا
تحقق مما إذا كان استخدام النموذج مشمولًا ضمن مخصصات مستوى السعة. إذا كان استخدام ذلك النموذج كله ضمن مخصصات الرموز في الدقيقة (TPM) لمستوى السعة، فقد يظهر استخدام في المشروع من دون إنفاق إضافي على النموذج.
تظل تكلفة اشتراك مستوى السعة محسوبة على مستوى المؤسسة. لمراجعتها:
امسح عامل تصفية المشروع في لوحة معلومات الاستخدام.
حدد فئات الإنفاق.
مراجعة مؤسسات متعددة
لا تجمع لوحة معلومات الاستخدام بيانات التكلفة أو الاستخدام بين المؤسسات. تُعامل كل مؤسسة، بما فيها المؤسسة الفرعية، بشكل منفصل.
لعرض مؤسسة فرعية، حددها في أداة اختيار المؤسسة.
إذا كنت بحاجة إلى تقارير موحّدة، ففكّر في استخدام مشاريع ضمن مؤسسة واحدة بدلًا من مؤسسات فرعية منفصلة، أو استخدم واجهة برمجة تطبيقات الاستخدام لإجراء تحليل مخصص.
التحقق من استخدام الرموز في استجابة API
تختلف أسماء حقول استخدام الرموز باختلاف نقطة النهاية.
| عدد الرموز | إكمالات المحادثات | Responses |
| رموز الإدخال | 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.
إذا انقطع التدفق، فقد لا تتلقى كتلة الاستخدام النهائية تلك. لا يعني غياب الكتلة النهائية أن الطلب لم يستخدم أي رموز.
هذا الإعداد خاص بإكمالات المحادثات. للتفاصيل، راجع مرجع واجهة برمجة تطبيقات إكمال المحادثات.