مرور کلی
مصرف API را به دو روش میتوانید بررسی کنید:
برای بررسی فعالیت در دورههای صورتحساب فعلی و گذشته، از داشبورد مصرف استفاده کنید.
برای بررسی یک درخواست، اطلاعات مصرف را در پاسخ API بخوانید.
Playground از همان فراخوانیهای API برنامههای شما استفاده میکند. توکنهای آن در مصرف API حساب شما محاسبه میشوند و از همان قواعد مصرف و قیمتگذاری پیروی میکنند.
دسترسی به داشبورد
برای دسترسی به داشبورد مصرف، باید مالک سازمان باشید یا مجوز داشبورد مصرف را داشته باشید.
بررسی مصرف در داشبورد
داشبورد مصرف را باز کنید، سازمان موردنظر را برگزینید و دوره گزارشدهی مربوط را انتخاب کنید.
دادههای داشبورد براساس UTC نمایش داده میشوند. هنگام مقایسه فعالیت داشبورد با گزارشهای برنامه خود، این منطقه زمانی را در نظر داشته باشید.
انتخاب پروژهها
داشبورد انتخابگر پروژه مخصوص خود را دارد. این انتخابگر مستقل از پروژهای است که در بخش دیگری از پلتفرم API انتخاب شده است.
با انتخابگر داشبورد میتوانید یک، چند یا همه پروژهها را بررسی کنید. برای مشاهده دادههای کلی سازمان، پروژههای انتخابشده را پاک کنید. اگر هیچ پروژهای انتخاب نشده باشد، داشبورد دادههای همه پروژهها را نشان میدهد.
بررسی مصرف یک کاربر
برای بررسی مصرف «پاسخها» و «تکمیلهای چت» یک کاربر:
در داشبورد مصرف، به قابلیتهای API > پاسخها و تکمیلهای چت بروید.
گزینه فیلتر براساس را انتخاب کنید.
در بخش کاربران، کاربر را انتخاب کنید و سپس اعمال فیلترها را بزنید.
مشاهده توکنها در هر دقیقه
در صفحات جزئیات مصرف میتوانید بازه را انتخاب کنید. برای بررسی تعداد توکن در دقیقه (TPM)، بازه یکدقیقهای را انتخاب کنید.
این بازه برای دادههای مصرف است، نه دادههای صورتحساب.
صدور دادههای مصرف
برای بازه زمانی صدور محدودیتی وجود ندارد. دادههای صادرشده برای دورههای طولانی ممکن است در چند فایل تقسیم شوند.
برای تطبیق صورتحساب ماهانه و صدور اقلام آن، به صدور جزئیات مصرف ماهانه مراجعه کنید.
مشاهده اعتبارهای اعطایی
جزئیات اعتبارهای اعطایی در صفحه صورتحساب سازمانتان موجود است.
اعتبارهای اعطایی و مصرف API اطلاعات متفاوتی ارائه میکنند: اعتبارهای اعطایی، اعتبارهای مرتبط با سازمان را نشان میدهند و مصرف، فعالیت API آن را نمایش میدهد.
بررسی مصرف و هزینههای رده مقیاسبندی
اگر رده مقیاسبندی برای سازمانتان فعال است و دسترسی لازم را دارید، برای مشاهده جزئیات مصرف، صفحه مصرف رده مقیاسبندی را باز کنید.
هزینه بستههای رده مقیاسبندی به سازمان تعلق میگیرد، نه به پروژههای جداگانه.
مصرف بیشتر از صفر است، اما هزینه پروژه صفر است
بررسی کنید که آیا مصرف مدل تحت پوشش سهمیه رده مقیاسبندی شماست. اگر کل مصرف آن مدل در محدوده سهمیه TPM رده مقیاسبندی باشد، ممکن است پروژه مصرف را بدون هزینه اضافی مدل نشان دهد.
هزینه اشتراک رده مقیاسبندی همچنان در سطح سازمان ثبت میشود. برای بررسی آن:
فیلتر پروژه را در داشبورد مصرف پاک کنید.
گزینه دستههای هزینه را انتخاب کنید.
بررسی چند سازمان
داشبورد مصرف، دادههای هزینه یا مصرف سازمانهای مختلف را با هم ترکیب نمیکند. هر سازمان، از جمله هر زیرسازمان، بهطور جداگانه در نظر گرفته میشود.
برای مشاهده یک زیرسازمان، آن را از انتخابگر سازمان انتخاب کنید.
اگر به گزارش ترکیبی نیاز دارید، بهجای زیرسازمانهای جداگانه از پروژههای یک سازمان استفاده کنید یا برای تحلیل سفارشی از API مصرف کمک بگیرید.
بررسی مصرف توکن در پاسخ API
نام فیلدهای مصرف توکن به نقطه پایان بستگی دارد.
| تعداد توکن | تکمیلهای چت | پاسخها |
| توکنهای ورودی | 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 است.
اگر جریان قطع شود، ممکن است بخش نهایی مصرف را دریافت نکنید. نبود بخش نهایی به این معنا نیست که درخواست هیچ توکنی مصرف نکرده است.
این پیکربندی مختص تکمیلهای چت است. برای جزئیات، به مرجع API تکمیلهای چت مراجعه کنید.