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