محدودیتها و Rate limit
حدود درخواست، ورودی، بدنهٔ JSON، هدرهای کنترلی و قابلیتهای فعلی نسخهٔ v1.
محدودیتهای قطعی
حدود ورودی و درخواست
پنجرهٔ یکدقیقهای
Rate limit چگونه کار میکند؟
محدودیت هم در سطح حساب و هم کلید اعمال میشود. در پاسخ 429 از Retry-After استفاده کنید.
| هدر | نوع | معنی |
|---|---|---|
X-RateLimit-Limit | number | حد درخواست در پنجرهٔ فعلی |
X-RateLimit-Remaining | number | تعداد درخواست باقیمانده |
X-RateLimit-Reset | Unix timestamp | زمان بازنشانی پنجره |
Retry-After | seconds | زمان پیشنهادی انتظار پس از 429 |
Retry سادهJavaScript
if (response.status === 429) {
const retryAfter = Number(response.headers.get('Retry-After') ?? 1)
await new Promise(resolve => setTimeout(resolve, retryAfter * 1000))
// درخواست را با backoff و سقف تلاش مشخص دوباره ارسال کنید.
}هدرهای مصرف
بدون parse کردن بدنه، مصرف را ببینید
| هدر | معنی |
|---|---|
X-API-Usage-Period | دورهٔ ماهانه با فرمت YYYY-MM |
X-API-Usage-Limit | سقف اعتبار ماهانهٔ پلن |
X-API-Usage-Used | اعتبار مصرفشده در دوره |
X-API-Credit-Balance | موجودی pay-as-you-go |
دامنهٔ v1
قابلیتهای فعلاً غیرفعال
—
Streaming پاسخ
در REST API عمومی v1 فعال نیست—
ورودی تصویر و فایل
در REST API عمومی v1 فعال نیست—
Tool / Function calling
در REST API عمومی v1 فعال نیست—
خروجی JSON ساختاریافته
در REST API عمومی v1 فعال نیست—
وبهوک
در REST API عمومی v1 فعال نیست—
پردازش دستهای
در REST API عمومی v1 فعال نیست