مصرف و تحلیل

مصرف پلتفرم Aize خود را با معیارها و بینش‌های جامع، پیگیری و تحلیل کنید.

بررسی کلی

صفحه مصرف و تحلیل، بینش‌های دقیقی درباره موارد زیر ارائه می‌دهد:

• حجم درخواست‌های API
• مصرف توکن
• تفکیک هزینه
• الگوهای مصرف مدل
• معیارهای عملکرد
• فعالیت تیم (برای مدیران/مالکان)

معیارهای کلیدی

کل درخواست‌ها

چه چیزی را نشان می‌دهد:

• شمار کل تمام فراخوانی‌های API از ابتدا
• شامل درخواست‌های موفق و ناموفق
• به‌صورت لحظه‌ای به‌روزرسانی می‌شود

کاربرد:

• درک حجم کلی مصرف
• برنامه‌ریزی ظرفیت
• پایش محدودیت نرخ
• تحلیل روند

مشاهده تفکیک بر اساس:

• بازه زمانی (روزانه، هفتگی، ماهانه)
• مدل
• کلید API
• عضو تیم (مدیران/مالکان)
• کد وضعیت (موفق/خطا)

کل توکن‌ها

چه چیزی را نشان می‌دهد:

• مجموع توکن‌های ورودی و خروجی
• جمع کل از ابتدا
• امکان مشاهده تفکیک جداگانه ورودی/خروجی

انواع توکن:

• توکن‌های ورودی: متنی که در پرامپت‌ها ارسال می‌کنید
• توکن‌های خروجی: پاسخ‌های تولیدشده
• کل توکن‌ها: مجموع هر دو

چرا اهمیت دارد:

• توکن‌های خروجی معمولاً 2 تا 3 برابر توکن‌های ورودی هزینه دارند
• به بهینه‌سازی مهندسی پرامپت کمک می‌کند
• نشان‌دهنده حجم داده پردازش‌شده است

راهنمای تبدیل:

• هر توکن تقریباً 4 نویسه است
• هر توکن تقریباً 0.75 کلمه است
• هر 100 توکن تقریباً 75 کلمه است
• هر 1000 توکن تقریباً 750 کلمه یا 1 تا 2 صفحه است

هزینه کل

چه چیزی را نشان می‌دهد:

• کل هزینه پرداختی از ابتدا، به دلار
• مجموع همه کسرهای بابت مصرف
• افزایش اعتبار و بازپرداخت را شامل نمی‌شود

اجزای هزینه:

Request Cost = (Base Model Cost × Tokens) × Markup + Fixed Fee

مشاهده تفکیک:

• هزینه به ازای هر مدل
• هزینه به ازای هر کلید API
• هزینه به ازای هر عضو تیم
• روند هزینه در طول زمان

هزینه دوره جاری

چه چیزی را نشان می‌دهد:

• هزینه دوره صورت‌حساب جاری
• بر اساس ردهٔ فضای کاری از نو شروع می‌شود
• پیشرفت نسبت به هر محدودیت بودجه تعیین‌شده

کدگذاری رنگی:

• سبز: زیر 75% بودجه
• زرد: 75 تا 90% بودجه
• قرمز: بالای 90% بودجه

گزارش فراخوانی‌های API

نمای دقیق هر فراخوانی API که به درگاه ارسال شده است.

اطلاعات رکورد درخواست

هر رکورد درخواست شامل موارد زیر است:

شناسایی درخواست:

• شناسه درخواست: UUID یکتا برای ردیابی
• برچسب زمانی: تاریخ و ساعت دقیق
• کلید API: کلید استفاده‌شده (برچسب نمایش داده می‌شود)
• کاربر: عضوی که درخواست را ارسال کرده (فقط برای کلیدهای تیمی)

اطلاعات مدل:

• نام مستعار مدل: آنچه درخواست کرده‌اید (مثلاً «gpt-5.4-mini»)
• مدل ارائه‌دهنده: مدلی که واقعاً استفاده شده (مثلاً «gpt-5.4-mini-2026-04»)
• نقطه پایانی: نقطه پایانی API فراخوانی‌شده (/v1/chat/completions)

مصرف توکن:

• توکن‌های ورودی: توکن‌های پرامپت شما
• توکن‌های خروجی: توکن‌های پاسخ
• کل توکن‌ها: مجموع هر دو

تفکیک هزینه:

• هزینه ارائه‌دهنده: مبلغی که ما به ارائه‌دهنده هوش مصنوعی می‌پردازیم
• هزینه مشتری: مبلغی که از شما دریافت می‌شود
• سود: سود ما (شفاف)
• کارمزد ثابت: کارمزد به ازای هر درخواست (در صورت وجود)

عملکرد:

• تأخیر: زمان تکمیل درخواست (میلی‌ثانیه)
• کد وضعیت: کد پاسخ HTTP (200، 401، 402 و غیره)
• پیام خطا: جزئیات در صورت ناموفق بودن درخواست

فراداده (قابل‌گسترش):

• پارامترهای مدل (دما، بیشینه توکن و غیره)
• درخواست/پاسخ کامل (در صورت فعال بودن ثبت گزارش)
• جزئیات مختص ارائه‌دهنده

فیلتر کردن گزارش‌ها

بر اساس بازه زمانی:

• یک ساعت گذشته
• ۲۴ ساعت گذشته
• ۷ روز گذشته
• ۳۰ روز گذشته
• بازه زمانی دلخواه

بر اساس وضعیت:

• همه درخواست‌ها
• فقط موفق (2xx)
• خطاهای سمت کاربر (4xx)
• خطاهای سمت سرور (5xx)

بر اساس مدل:

• فیلتر بر اساس مدل خاص
• مقایسه بین مدل‌ها
• شناسایی پرکاربردترین مدل‌ها

بر اساس کلید API:

• مشاهده گزارش‌های یک کلید خاص
• برای عیب‌یابی مفید است
• پیگیری الگوهای مصرف کلید

بر اساس کاربر (فقط مدیران/مالکان):

• مشاهده فعالیت اعضای تیم
• شناسایی کاربران پرمصرف
• پیگیری هزینه‌های هر فرد

«فقط گزارش‌های من» (اعضا):

• با فعال کردن این گزینه، فقط درخواست‌های خودتان را می‌بینید
• فعالیت تیم را پنهان می‌کند
• نمایی متمرکز بر حریم خصوصی

صفحه‌بندی

• اندازه صفحه: 50 رکورد در هر صفحه
• بارگذاری بیشتر: برای دیدن رکوردهای قدیمی‌تر کلیک کنید
• خروجی: دانلود به‌صورت CSV (به‌زودی)

تحلیل هزینه

درک هزینه‌ها

هزینه ارائه‌دهنده در برابر هزینه مشتری:

Provider Cost: $0.10      (what we pay)
Markup (25%):   $0.025    (our margin)
Fixed Fee:      $0.01     (per-request fee)
─────────────────────────
Customer Cost:  $0.135    (what you pay)

چرا این تفاوت وجود دارد؟:

• هزینه‌های زیرساخت
• پشتیبانی و نگهداری
• کارمزد پردازش پرداخت
• تضمین‌های قابلیت اطمینان سرویس
• ویژگی‌های اضافی (کش، مسیریابی، جایگزینی خودکار)

شفافیت:

• هر دو هزینه در گزارش فراخوانی‌های API نمایش داده می‌شود
• درصد سود به‌روشنی مشخص است
• بدون کارمزد پنهان
• قیمت‌گذاری قابل‌پیش‌بینی

نکات بهینه‌سازی هزینه

1. مدل مناسب را انتخاب کنید:

• وظایف ساده: از GPT-5.4 Nano یا GLM-4.7 Flash استفاده کنید (حدود 10 برابر ارزان‌تر از GPT-5.4)
• استفاده متعادل: GPT-5.4 Mini بهترین گزینه پیش‌فرض برای بیشتر کارهاست
• استدلال پیچیده: از GPT-5.4 یا Claude 4.6 Sonnet استفاده کنید
• وظایف سازمانی: Claude 4.8 Opus برای سنگین‌ترین بارهای کاری

2. پرامپت‌ها را بهینه کنید:

• مختصر اما واضح باشید
• مثال‌های غیرضروری را حذف کنید
• از پیام‌های سیستم به‌طور کارآمد استفاده کنید
• از دستورالعمل‌های تکراری پرهیز کنید

3. طول خروجی را کنترل کنید:

• max_tokens مناسب را تنظیم کنید
• بیش از نیاز درخواست ندهید
• توکن‌های خروجی هزینه بیشتری نسبت به ورودی دارند

4. از استریم استفاده کنید:

• هزینه یکسان، تجربه کاربری بهتر
• کاربران نتایج را سریع‌تر می‌بینند
• در صورت کافی بودن پاسخ، قابل لغو است

5. کش را پیاده‌سازی کنید:

• پاسخ‌های پرتکرار را کش کنید
• درخواست‌های تکراری را کاهش دهید
• صرفه‌جویی چشمگیر برای برنامه‌های پرترافیک

6. محدودیت بودجه تعیین کنید:

• محدودیت ماهانه به ازای هر کلید
• بودجه هر عضو تیم
• هشدار پیش از خرج بیش از حد

تحلیل هزینه به ازای هر درخواست

میانگین هزینه:

Average = Total Cost / Total Requests

پیگیری روندها:

• آیا میانگین در حال افزایش است؟ (استفاده از مدل‌های گران‌تر؟)
• جهش‌های ناگهانی؟ (خروجی‌های طولانی‌تر یا خطاها؟)
• مقایسه با انتظارات بودجه

میانگین‌های نمونه به ازای هر مدل:

• GPT-5.4 Nano: $0.0002 تا $0.001 به ازای هر درخواست
• GPT-5.4 Mini: $0.001 تا $0.005 به ازای هر درخواست
• GPT-5.4: $0.01 تا $0.05 به ازای هر درخواست
• Claude 4.8 Opus: $0.015 تا $0.075 به ازای هر درخواست

تحلیل عملکرد

معیارهای تأخیر

آنچه اندازه‌گیری می‌شود:

• زمان از دریافت درخواست تا تکمیل پاسخ
• شامل موارد زیر:
  • زمان پردازش API
  • زمان استنتاج مدل
  • تأخیر شبکه
  • زمان انتظار در صف (در صورت وجود)

تأخیرهای معمول:

• مدل‌های سریع (GPT-5.4 Nano، GLM-4.7 Flash): 500 تا 2000 میلی‌ثانیه
• مدل‌های استاندارد (GPT-5.4 Mini، GPT-5.4): 2000 تا 5000 میلی‌ثانیه
• خروجی‌های حجیم: می‌تواند بیش از 10 ثانیه طول بکشد

پایش:

• میانگین تأخیر به ازای هر مدل
• صدک‌های P50، P95 و P99 (به‌زودی)
• شناسایی درخواست‌های کند
• پیگیری روند عملکرد

نرخ موفقیت

کدهای وضعیت HTTP:

• موفقیت 2xx: درخواست با موفقیت تکمیل شد
• خطای سمت کاربر 4xx: مشکلی در درخواست شما وجود دارد
• خطای سمت سرور 5xx: مشکل از سمت ما یا ارائه‌دهنده است

پیگیری نرخ موفقیت:

Success Rate = (2xx responses / Total responses) × 100%

هدف: نرخ موفقیت بالای 99%

خطاهای رایج:

• 401 Unauthorized: کلید API نامعتبر
• 402 Payment Required: موجودی ناکافی
• 403 Forbidden: مدل برای این کلید مجاز نیست
• 429 Too Many Requests: محدودیت نرخ درخواست رد شده است
• 500 Internal Server Error: مشکل موقت
• 503 Service Unavailable: ارائه‌دهنده در دسترس نیست

تحلیل خطاها

مشاهده خطاها:

1. به گزارش فراخوانی‌های API بروید
2. بر اساس کد وضعیت فیلتر کنید (4xx، 5xx)
3. پیام‌های خطا را بررسی کنید
4. الگوها را شناسایی کنید

الگوهای رایج:

• جهش در خطاهای 429: نیاز به افزایش محدودیت نرخ
• خطاهای 401: کلید لغو یا مسدود شده است
• خطاهای 402: کیف پول نیاز به شارژ مجدد دارد
• خطاهای 500: در صورت تداوم، با پشتیبانی تماس بگیرید

تحلیل تیمی (مدیر/مالک)

مصرف به ازای هر عضو

مشاهده فعالیت هر عضو:

1. به گزارش فراخوانی‌های API بروید
2. بر اساس عضو تیم فیلتر کنید
3. معیارهای آن‌ها را ببینید:
   • کل درخواست‌ها
   • مصرف توکن
   • هزینه صرف‌شده
   • مدل‌های استفاده‌شده
   • نرخ خطا

موارد استفاده:

• شناسایی کاربران پرمصرف
• تخصیص بودجه
• شناسایی نیازهای آموزشی
• انتساب هزینه

تحلیل به ازای هر کلید

پیگیری مصرف کلید API:

1. به گزارش فراخوانی‌های API بروید
2. بر اساس کلید API فیلتر کنید
3. تحلیل کنید:
   • الگوهای مصرف
   • روند هزینه
   • نرخ خطا
   • ترجیحات مدل

موارد استفاده:

• شناسایی کلیدهای مشکل‌دار
• بهینه‌سازی محدودیت‌های کلید
• عیب‌یابی مشکلات یکپارچه‌سازی
• برنامه‌ریزی چرخش کلید

روند هزینه تیم

پایش هزینه‌های تیم:

• تفکیک هزینه روزانه
• روند هفته‌به‌هفته
• رشد ماه‌به‌ماه
• انتساب هزینه به ازای هر عضو

تعیین بودجه تیم:

• محدودیت‌های سطح فضای کاری
• محدودیت به ازای هر کلید
• سقف مصرف به‌ازای هر عضو (از طریق محدودیت کلید)
• هشدار در صورت عبور از آستانه

خروجی گرفتن و گزارش‌دهی

خروجی گرفتن از داده‌ها

قالب‌های در دسترس:

• CSV (به‌زودی)
• JSON (به‌زودی)
• دسترسی API (به‌زودی)

آنچه می‌توانید خروجی بگیرید:

• گزارش فراخوانی‌های API
• گزارش‌های هزینه
• خلاصه مصرف
• تفکیک توکن‌ها

موارد استفاده:

• تطبیق مالی
• تحلیل‌های سفارشی
• هوش تجاری
• گزارش‌دهی انطباقی

گزارش‌های زمان‌بندی‌شده

به‌زودی:

• خلاصه مصرف روزانه
• گزارش هفتگی هزینه
• تحلیل ماهانه هزینه
• زمان‌بندی گزارش سفارشی

کنترل دسترسی

چه کسی می‌تواند تحلیل‌ها را ببیند؟

حریم خصوصی

حریم خصوصی اعضا:

• اعضا فقط فعالیت خود را می‌بینند
• امکان مشاهده هزینه‌های تیم وجود ندارد
• دسترسی به گزارش‌های سایر اعضا وجود ندارد
• گزینه‌ای مناسب برای پیمانکاران/مشاوران

شفافیت تیمی:

• مدیران/مالکان همه فعالیت‌ها را می‌بینند
• برای مدیریت هزینه ضروری است
• بودجه‌بندی درست را ممکن می‌سازد
• از پاسخ‌گویی پشتیبانی می‌کند

بهترین شیوه‌ها

پایش منظم

روزانه:

• موجودی کیف پول را بررسی کنید
• خطاهای احتمالی را مرور کنید
• روند هزینه را پایش کنید

هفتگی:

• مصرف به ازای هر کلید را تحلیل کنید
• فعالیت تیم را مرور کنید
• ناهنجاری‌ها را بررسی کنید

ماهانه:

• تحلیل کامل هزینه انجام دهید
• مصرف مدل‌ها را مرور کنید
• بودجه را با مقدار واقعی مقایسه کنید
• بر اساس روندها بهینه‌سازی کنید

تنظیم هشدارها

هشدارهای کیف پول:

• آستانه موجودی کم (پیش‌فرض $10)
• ارسال ایمیل هنگام فعال شدن
• قابل تنظیم در تنظیمات فضای کاری

هشدارهای کلید API:

• هشدار محدودیت ماهانه (75%، 90%، 100%)
• مسدودسازی خودکار در رسیدن به محدودیت
• اطلاع‌رسانی ایمیلی

هشدارهای مصرف (به‌زودی):

• آستانه هزینه روزانه
• شناسایی فعالیت غیرعادی
• جهش نرخ خطا

حاکمیت هزینه

برای تیم‌های کوچک:

• محدودیت ماهانه معقول برای هر کلید تعیین کنید
• به‌صورت هفتگی پایش کنید
• به‌صورت ماهانه روندها را مرور کنید

برای تیم‌های بزرگ‌تر:

• محدودیت هر کلید به‌طور دقیق اعمال می‌شود
• سقف مصرف به‌ازای هر عضو
• فرایند تأیید برای کلیدهای با محدودیت بالا
• مرور ماهانه هزینه با سرپرستان تیم

عیب‌یابی

گزارش‌های ناموجود

مشکل: فراخوانی‌های اخیر در گزارش دیده نمی‌شوند

دلایل احتمالی:

• فیلتری اعمال شده است (تنظیمات فیلتر را بررسی کنید)
• گزینه «فقط گزارش‌های من» فعال است (اگر دنبال گزارش‌های تیم هستید)
• صفحه به‌روزرسانی نشده است (برای دیدن آخرین موارد، صفحه را تازه‌سازی کنید)

راه‌حل: فیلترها را پاک کرده و صفحه را تازه‌سازی کنید

هزینه‌ها با انتظارات مطابقت ندارد

مشکل: هزینه‌ها بیشتر از حد انتظار است

مراحل بررسی:

1. گزارش فراخوانی‌های API را برای فراخوانی‌های پرهزینه بررسی کنید
2. مشخص کنید کدام مدل‌ها استفاده شده‌اند (GPT-5.4 در برابر GPT-5.4 Mini)
3. تعداد توکن‌ها را بررسی کنید (خروجی‌های غیرمنتظره طولانی؟)
4. خطاها را بررسی کنید (تلاش‌های مجدد می‌توانند هزینه را دو برابر کنند)
5. مصرف کلید API را مرور کنید (آیا کلیدی بیش از حد استفاده شده است؟)

راه‌حل‌ها:

• در صورت امکان به مدل‌های ارزان‌تر تغییر دهید
• پارامتر max_tokens را کاهش دهید
• پرامپت‌ها را مختصرتر کنید
• علت خطاها را برطرف کنید تا از تلاش مجدد جلوگیری شود
• محدودیت‌های سخت‌گیرانه‌تری برای کلید API تعیین کنید

نرخ خطای بالا

مشکل: تعداد زیادی درخواست ناموفق

بررسی کنید:

1. گزارش‌ها را بر اساس وضعیت خطا فیلتر کنید (4xx، 5xx)
2. پیام‌های خطا را بخوانید
3. الگوها را شناسایی کنید (همان کلید؟ همان مدل؟ همان زمان؟)

راه‌حل‌های رایج:

• 401: معتبر بودن کلید API را بررسی کنید
• 402: کیف پول را شارژ کنید
• 429: نرخ درخواست را کاهش دهید یا برای افزایش محدودیت تماس بگیرید
• 500/503: کمی صبر کرده و دوباره تلاش کنید، یا در صورت تداوم با پشتیبانی تماس بگیرید

مراحل بعدی

• محدودیت کلید API تنظیم کنید
• موجودی کیف پول را پایش کنید
• گزارش رخدادها را مرور کنید