محدودیت مصرف

کنترل مصرف روی هر کلید، هر مدل و هر کاربر.

سطوح محدودیت

  • RPM — حداکثر تعداد درخواست در دقیقه.
  • TPM — حداکثر تعداد توکن در دقیقه (مجموع ورودی + خروجی).
  • بودجۀ روزانه/ماهانه — سقف هزینۀ ریالی برای هر کلید.
  • مدل‌های مجاز — فهرست مدل‌های قابل استفاده با هر کلید.
  • موجودی کیف پول — اگر موجودی کافی نباشد درخواست رد می‌شود.

هدرهای پاسخ

هر پاسخ موفق شامل هدرهای زیر است:

  • x-ratelimit-limit-requests
  • x-ratelimit-remaining-requests
  • x-ratelimit-reset-requests
  • x-ratelimit-limit-tokens
  • x-ratelimit-remaining-tokens
  • x-ratelimit-reset-tokens

۴۲۹ Too Many Requests

هنگام دریافت کد ۴۲۹، درخواست را با تأخیر نمایی (exponential backoff) تکرار کنید: مثلاً ۱، ۲، ۴، ۸ ثانیه.

سفارشی‌سازی

مدیر سازمان می‌تواند در صفحۀ کلیدهای API روی هر کلید سقف اختصاصی تعریف کند: RPM، TPM، بودجۀ روزانه، بودجۀ ماهانه و فهرست مدل‌ها.