مستنداتمحدودیت‌ها
مدیریت API
مستندات API / محدودیت‌ها

محدودیت‌ها و Rate limit

حدود درخواست، ورودی، بدنهٔ JSON، هدرهای کنترلی و قابلیت‌های فعلی نسخهٔ v1.

محدودیت‌های قطعی

حدود ورودی و درخواست

۶۴KBحداکثر اندازهٔ بدنهٔ JSON
۲۴٬۰۰۰حداکثر مجموع کاراکترهای پیام‌ها
۱۲٬۰۰۰حداکثر هر پیام یا prompt
۵حداکثر کلید API فعال برای هر حساب

پنجرهٔ یک‌دقیقه‌ای

Rate limit چگونه کار می‌کند؟

محدودیت هم در سطح حساب و هم کلید اعمال می‌شود. در پاسخ 429 از Retry-After استفاده کنید.
هدرنوعمعنی
X-RateLimit-Limitnumberحد درخواست در پنجرهٔ فعلی
X-RateLimit-Remainingnumberتعداد درخواست باقی‌مانده
X-RateLimit-ResetUnix timestampزمان بازنشانی پنجره
Retry-Aftersecondsزمان پیشنهادی انتظار پس از 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 فعال نیست