احراز هویت و کلیدهای API

• کلید را در هدر Authorization: Bearer pul_… بفرستید. هدر x-api-key هم پذیرفته می‌شود.
• هر کلید به یک اپ (پروژه) تعلق دارد. مصرف و هزینه‌ی هر درخواست به همان اپ نوشته می‌شود و این را نمی‌شود از سمت کلاینت تغییر داد.
• دسترسی‌ها (scopes):
  • inference: فراخوانی مدل‌ها و فهرست مدل‌ها
  • models:read: فقط فهرست مدل‌ها
• محیط: کلیدهای pul_test_ برای توسعه و کلیدهای pul_live_ برای محیط عملیاتی هستند.
• چرخش: دکمه‌ی «چرخش» کلید تازه‌ای می‌سازد و کلید قبلی را بلافاصله باطل می‌کند.
• لغو: ابطال فوری است و همه‌ی نمونه‌های درگاه آن را در چند ثانیه اعمال می‌کنند.
• پُل متن کلید را ذخیره نمی‌کند و فقط هش آن را نگه می‌دارد. اگر کلید را گم کردید، کلید جدید بسازید.
• کلید را هرگز در کد سمت مرورگر یا اپ موبایل قرار ندهید. درخواست‌ها را از سرور خودتان بفرستید.

محدودیت نرخ

درخواست‌ها برای هر کلید و هر اپ به‌طور جداگانه محدود می‌شوند. وقتی از سقف بگذرید، پاسخ 429 با کد rate_limit_exceeded و هدر Retry-After برمی‌گردد.