مرور کلی
مصرف API را به دو روش می‌توانید بررسی کنید:
برای بررسی فعالیت در دوره‌های صورت‌حساب فعلی و گذشته، از داشبورد مصرف استفاده کنید.
برای بررسی یک درخواست، اطلاعات مصرف را در پاسخ API بخوانید.
Playground از همان فراخوانی‌های API برنامه‌های شما استفاده می‌کند. توکن‌های آن در مصرف API حساب شما محاسبه می‌شوند و از همان قواعد مصرف و قیمت‌گذاری پیروی می‌کنند.
دسترسی به داشبورد
برای دسترسی به داشبورد مصرف، باید مالک سازمان باشید یا مجوز داشبورد مصرف را داشته باشید.
بررسی مصرف در داشبورد
داشبورد مصرف را باز کنید، سازمان موردنظر را برگزینید و دوره گزارش‌دهی مربوط را انتخاب کنید.
داده‌های داشبورد براساس UTC نمایش داده می‌شوند. هنگام مقایسه فعالیت داشبورد با گزارش‌های برنامه خود، این منطقه زمانی را در نظر داشته باشید.
انتخاب پروژه‌ها
داشبورد انتخاب‌گر پروژه مخصوص خود را دارد. این انتخاب‌گر مستقل از پروژه‌ای است که در بخش دیگری از پلتفرم API انتخاب شده است.
با انتخاب‌گر داشبورد می‌توانید یک، چند یا همه پروژه‌ها را بررسی کنید. برای مشاهده داده‌های کلی سازمان، پروژه‌های انتخاب‌شده را پاک کنید. اگر هیچ پروژه‌ای انتخاب نشده باشد، داشبورد داده‌های همه پروژه‌ها را نشان می‌دهد.
بررسی مصرف یک کاربر
برای بررسی مصرف «پاسخ‌ها» و «تکمیل‌های چت» یک کاربر:
در داشبورد مصرف، به قابلیت‌های API > پاسخ‌ها و تکمیل‌های چت بروید.
گزینه فیلتر براساس را انتخاب کنید.
در بخش کاربران، کاربر را انتخاب کنید و سپس اعمال فیلترها را بزنید.
مشاهده توکن‌ها در هر دقیقه
در صفحات جزئیات مصرف می‌توانید بازه را انتخاب کنید. برای بررسی تعداد توکن در دقیقه (TPM)، بازه یک‌دقیقه‌ای را انتخاب کنید.
این بازه برای داده‌های مصرف است، نه داده‌های صورت‌حساب.
صدور داده‌های مصرف
برای بازه زمانی صدور محدودیتی وجود ندارد. داده‌های صادرشده برای دوره‌های طولانی ممکن است در چند فایل تقسیم شوند.
برای تطبیق صورت‌حساب ماهانه و صدور اقلام آن، به صدور جزئیات مصرف ماهانه مراجعه کنید.
مشاهده اعتبارهای اعطایی
جزئیات اعتبارهای اعطایی در صفحه صورت‌حساب سازمانتان موجود است.
اعتبارهای اعطایی و مصرف API اطلاعات متفاوتی ارائه می‌کنند: اعتبارهای اعطایی، اعتبارهای مرتبط با سازمان را نشان می‌دهند و مصرف، فعالیت API آن را نمایش می‌دهد.
بررسی مصرف و هزینه‌های رده مقیاس‌بندی
اگر رده مقیاس‌بندی برای سازمانتان فعال است و دسترسی لازم را دارید، برای مشاهده جزئیات مصرف، صفحه مصرف رده مقیاس‌بندی را باز کنید.
هزینه بسته‌های رده مقیاس‌بندی به سازمان تعلق می‌گیرد، نه به پروژه‌های جداگانه.
مصرف بیشتر از صفر است، اما هزینه پروژه صفر است
بررسی کنید که آیا مصرف مدل تحت پوشش سهمیه رده مقیاس‌بندی شماست. اگر کل مصرف آن مدل در محدوده سهمیه TPM رده مقیاس‌بندی باشد، ممکن است پروژه مصرف را بدون هزینه اضافی مدل نشان دهد.
هزینه اشتراک رده مقیاس‌بندی همچنان در سطح سازمان ثبت می‌شود. برای بررسی آن:
فیلتر پروژه را در داشبورد مصرف پاک کنید.
گزینه دسته‌های هزینه را انتخاب کنید.
بررسی چند سازمان
داشبورد مصرف، داده‌های هزینه یا مصرف سازمان‌های مختلف را با هم ترکیب نمی‌کند. هر سازمان، از جمله هر زیرسازمان، به‌طور جداگانه در نظر گرفته می‌شود.
برای مشاهده یک زیرسازمان، آن را از انتخاب‌گر سازمان انتخاب کنید.
اگر به گزارش ترکیبی نیاز دارید، به‌جای زیرسازمان‌های جداگانه از پروژه‌های یک سازمان استفاده کنید یا برای تحلیل سفارشی از API مصرف کمک بگیرید.
بررسی مصرف توکن در پاسخ API
نام فیلدهای مصرف توکن به نقطه پایان بستگی دارد.
| تعداد توکن‌ها | Chat Completions | Responses |
|---|---|---|
| توکن‌های ورودی | usage.prompt_tokens | usage.input_tokens |
| توکن‌های خروجی | usage.completion_tokens | usage.output_tokens |
| مجموع توکن‌ها | usage.total_tokens | usage.total_tokens |
برای مثال، پاسخ Chat Completions می‌تواند شامل موارد زیر باشد:
{
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
}
}بسته به نقطه پایان و مدل، جزئیات مصرف می‌تواند شامل تعداد توکن‌های ورودی ذخیره‌شده در حافظه نهان و توکن‌های استدلال نیز باشد. این جزئیات به درک این موضوع کمک می‌کنند که چرا طول بخش قابل‌مشاهده پاسخ، میزان کل مصرف توکن آن را نشان نمی‌دهد.
برای آشنایی با دسته‌های مختلف توکن، به آشنایی با توکن‌ها و شمارش آن‌ها مراجعه کنید.
دریافت اطلاعات مصرف از پاسخ‌های جریانی Chat Completions
برای درخواست جریانی Chat Completions، موارد زیر را اضافه کنید:
{
"stream": true,
"stream_options": {
"include_usage": true
}
}با فعال بودن include_usage، یک قطعه اضافی پیش از data: [DONE] ارسال می‌شود که حاوی اطلاعات مصرف کل درخواست است. آرایه choices در این قطعه خالی است. در سایر قطعه‌ها، مقدار usage برابر با null است.
اگر جریان قطع شود، ممکن است آن قطعه نهایی حاوی اطلاعات مصرف را دریافت نکنید. دریافت نشدن قطعه نهایی ثابت نمی‌کند که درخواست هیچ توکنی مصرف نکرده است.
این پیکربندی مختص Chat Completions است. برای جزئیات، به مستندات مرجع API های انتهای چت مراجعه کنید.