حدود الاستعمال
الحدود لكل مشروع، وتُقاس بالطلبات في الدقيقة والرموز في الدقيقة، وترتفع تلقائياً مع ما تدفعه ومرور الوقت.
المستويات
| المستوى | الشرط | حد الإنفاق الشهري | طلبات في الدقيقة | رموز في الدقيقة |
|---|---|---|---|---|
| 1 | أول دفعة 5$ | $100 | 500 | 500K |
| 2 | 50$ مدفوعة، ومرور 7 أيام | $500 | 2,000 | 2M |
| 3 | 250$ مدفوعة، ومرور 14 يوماً | $2,000 | 5,000 | 5M |
| 4 | 1,000$ مدفوعة، ومرور 30 يوماً | $10,000 | 10,000 | 10M |
| 5 | 5,000$ مدفوعة، ومرور 30 يوماً | $200,000 | 20,000 | 30M |
الرموز المقروءة من الكاش لا تُحسب ضمن حد الرموز في الدقيقة.
رؤوس الرد
| الرأس | المعنى |
|---|---|
x-ratelimit-limit-requests | حد الطلبات في الدقيقة |
x-ratelimit-remaining-requests | الطلبات الباقية |
x-ratelimit-remaining-tokens | الرموز الباقية |
retry-after | الثواني قبل المحاولة التالية، مع 429 |
x-request-id | معرّف الطلب، أرسله مع أي سؤال للدعم |
عند بلوغ الحد
يرجع الطلب برمز 429 في حالتين: تجاوزت السرعة (الطلبات أو الرموز في الدقيقة)، أو بلغت الحصّة (سقف الإنفاق الشهري أو نفاد الرصيد). النوع في جسم الخطأ يفرّق بينهما.
| النوع | السبب | ماذا تفعل |
|---|---|---|
rate_limit_exceeded | طلبات أو رموز أكثر من حدّ الدقيقة. | انتظر ما في retry-after ثم أعد المحاولة. |
quota_exceeded | بلغت سقف الإنفاق أو نفد الرصيد. | ارفع السقف أو اشحن الرصيد. إعادة المحاولة لا تفيد. |
أعد المحاولة بتأخيرٍ متزايد
client = OpenAI( base_url="https://api.optes3.com/v1", api_key=os.environ["OPTES_API_KEY"], max_retries=4, # retries 429 and 5xx with exponential backoff)const client = new OpenAI({ baseURL: "https://api.optes3.com/v1", apiKey: process.env.OPTES_API_KEY, maxRetries: 4,});الأسعار بالدولار الأمريكي، وهي أوّلية حتى الإطلاق. الواجهة البرمجية والتسجيل والمفاتيح تُفتح يوم الإطلاق.