مع تزايد دمج مساعدي الترميز المدعومين بالذكاء الاصطناعي في سير عمل المطورين، اكتسبت أدوات مثل Cursor AI شعبية لتقديم دعم AI سلس داخل المحرر باستخدام نماذج مثل GPT-4 من OpenAI وClaude 3.5 من Anthropic. ومع ذلك، يتم الإبلاغ عن خطأ شائع من قبل المستخدمين عند ربط مفتاح API الخاص بهم بـ Cursor وهو:
يمكن أن يكون هذا الخطأ معطلاً، خاصةً عندما يظهر بشكل غير متوقع في منتصف جلسة الترميز. بينما قد يبدو كأنه مشكلة من جانب Cursor، فإن السبب الجذري عادة ما يكمن في مزود API الذي يتم استخدام مفتاحه.
في هذه المقالة، سنقدم نظرة مفصلة حول ما يسبب هذه المشكلة، وكيف تعمل من وراء الكواليس، وما الخطوات التي يمكنك اتخاذها لحلها.
لماذا أواجه خطأ "تجاوز حد معدل مفتاح API المقدم من المستخدم" في Cursor؟
يتم إرجاع رسالة "تجاوز حد معدل مفتاح API المقدم من المستخدم" من قبل مزود API الذي قمت بربط Cursor به—مثل OpenAI أو Anthropic—وليس من قبل Cursor نفسه.
كما أكد أحد أعضاء فريق Cursor في خيط المنتدى:
“لا أعتقد أننا نفرض أي حدود على استخدام مفتاح API الخاص بك، لذا ستكون هذه الحدود مفروضة من الطرف الآخر (Anthropic أو OpenAI).”
هذا يعني أن Cursor يقوم ببساطة بنقل الخطأ من API upstream. عندما تستخدم مفتاح API الخاص بك في Cursor، فإنه يعمل كعميل لتلك الخدمات. إذا كان مفتاحك يقوم بإجراء الكثير من الطلبات، متجاوزًا حدود الرموز أو hitting quota caps، فسيقوم المزود برفض الطلبات الإضافية وإرجاع خطأ حد المعدل.
ما الذي يسبب خطأ حد المعدل؟
1. حدود الحساب في OpenAI أو Anthropic
يفرض كل مزود API حدودًا على المعدل تختلف بحسب:
نوع الحساب (مجاني، ادفع كما تذهب، أو مؤسسة)
نوع النموذج (مثل، GPT-3.5 مقابل GPT-4 أو Claude 3.5)
حالة الفواتير الحالية (سواء تم إضافة وسيلة دفع)
إنتاجية الرموز لكل دقيقة أو يوم
على سبيل المثال، تفرض OpenAI حدودًا على كلاً من الطلبات في الدقيقة (RPM) و الرموز في الدقيقة (TPM). يحتوي GPT-4، وخاصةً نسخة السياق 32k، على حدود أكثر صرامة مقارنةً بـ GPT-3.5. لدى Claude 3.5 Sonnet، الذي تقدمه Anthropic، قواعد تسعير وحصة خاصة به.
2. تجاوز الحصص المجانية أو التجريبية
إذا كنت تستخدم مفتاحًا من الطبقة المجانية أو كنت داخل فترة تجريبية على منصة OpenAI، قد تكون محدودًا في حد الاستخدام المنخفض جدًا. بمجرد أن تصل إلى تلك الحدود، سيتم حظر الطلبات الإضافية حتى يتم إعادة تعيين الحصة أو ترقيتك إلى خطة مدفوعة.
3. استخدام Cursor للميزات المميزة
يمكن لمستخدمي Cursor Pro الاستفادة من نماذج أكثر تقدمًا مثل Claude 3.5 Sonnet. ومع ذلك، حتى ضمن خطة Pro، لا تزال حدود الاستخدام سارية. بشكل افتراضي، تتضمن Cursor 500 "طلبات سريعة" كجزء من اشتراك Pro.
شرح أحد أعضاء فريق Cursor:
“لقد قمنا الآن بتمكين تسعير قائم على الاستخدام لمستخدمي Pro الذين يستخدمون نماذج مميزة، مما يعني أنه إذا تجاوزت 500 طلب سريع ولكن لا تريد شراء 500 أخرى، يمكنك تفعيل تسعير الاستخدام.”
إذا لم تقم بالتحويل إلى تسعير قائم على الاستخدام أو شراء طلبات سريعة إضافية، سيتوقف النظام عن معالجة الطلبات بمجرد الوصول إلى السقف.
للسياق، يتم تسعير Claude 3.5 Sonnet بمبلغ 0.04 دولار لكل طلب عبر Cursor، وهو ما يعادل 20 دولارًا لـ 500 طلب.
4. الطلبات الخلفية من Cursor
من الجدير بالذكر أيضًا أن Cursor قد يرسل طلبات خلفية إلى API أثناء الترميز—على سبيل المثال، لتوليد سلاسل الوثائق، والإجابة على الأسئلة المضمنة، أو اقتراح إعادة هيكلة. يمكن أن تتجمع هذه الطلبات بسرعة، خاصةً خلال جلسات طويلة.
كيفfix خطأ "تجاوز حد معدل مفتاح API المقدم من المستخدم"
قبل تطبيق أي إصلاح، من المهم تحديد السبب الدقيق لحد المعدل. إليك بعض الخطوات لاستكشاف الأخطاء:
تحقق من لوحة استخدام API الخاصة بك
لـ OpenAI:
قم بزيارة https://platform.openai.com/account/usage للاطلاع على إحصائيات الاستخدام في الوقت الفعلي، والحصة المتبقية، وتاريخ الطلبات الأخيرة.
لـ Anthropic (Claude):
زر موقع لوحة التحكم الخاصة بهم أو تحقق من تاريخ فوترة الحساب لضمان عدد الطلبات التي تم إجراؤها وما هي الحدود المطبقة.
قم بمراجعة ما إذا كنت قد تجاوزت إنتاجية الرموز (TPM) أو عدد الطلبات (RPM) أو وصلت إلى حصة يومية.
أضف وسيلة دفع إلى حساب API الخاص بك
إذا كنت تستخدم حسابًا من الطبقة المجانية أو التجريبية، فإن إضافة وسيلة دفع صالحة ستزيد من حدود المعدل وتفتح معدلات طلب ورموز أعلى.
لـ OpenAI:
أضف تفاصيل الفوترة على https://platform.openai.com/account/billing
لـ Anthropic:
اعتمادًا على سياسة الوصول الحالية للنموذج الخاص بهم، قد يكون تمكين الفوترة مطلوبًا للوصول إلى API beyond free tiers.
بمجرد تمكين الفوترة، ستزيد حصصك عادةً، وسينخفض احتمال مواجهتك لهذا الخطأ بشكل كبير.
انتقل إلى نموذج بتكلفة أقل أو حدود أقل
إذا لم تكن بحاجة إلى قدرات GPT-4 أو Claude 3.5 لمهمتك الحالية، فكر في الانتقال إلى نموذج أقل مثل GPT-3.5. هذه النماذج:
- لديها حدود استخدام أعلى
- غالبًا ما تكون أسرع في وقت الاستجابة
- أكثر اقتصادية
في Cursor، انتقل إلى:
- الإعدادات > إعدادات AI
- اختر نموذجًا مثل
gpt-3.5-turboإذا كان متاحًا
سيؤدي هذا التغيير إلى تقليل معدل رفض API الخاص بك على الفور.
راجع اشتراك Cursor وإعداداته
انتقل إلى الإعدادات > الفوترة في Cursor للتحقق مما إذا كنت على خطة Pro.
تحقق مما إذا كنت تستخدم مفتاح API مخصص أو الوصول إلى API المدمج.
إذا كنت على Pro وتستخدم Claude أو GPT-4، فحدد ما إذا كنت قد تجاوزت حد طلبات السريعة الشهري الخاص بك.
تعطيل مفتاح API المخصص واستخدام المفتاح المدمج في Cursor
إذا كانت عملية استكشاف الأخطاء الخاصة بمفتاحك تشكل تحديًا أو استغرقت وقتًا طويلاً، يمكنك تعطيل المفتاح المخصص وترك Cursor تتولى استخدام API باستخدام مفتاحها الداخلي.
لتعطيل المفتاح المخصص:
- انتقل إلى الإعدادات > إعدادات AI
- قم بإلغاء تحديد "استخدام مفتاح API الخاص بك"
يرجى ملاحظة أن هذه الخيارات قد لا تكون متاحة لجميع المستخدمين حسب خطتهم أو منطقتهم.
قم بالتبديل إلى تسعير قائم على الاستخدام في Cursor
إذا كنت مستخدمًا محترفًا في Cursor وقد استنفدت طلباتك السريعة الـ 500، يمكنك الاشتراك في الفوترة القائمة على الاستخدام. هذا يسمح لك بالاستمرار في استخدام النماذج المميزة مثل Claude 3.5 دون الحاجة إلى شراء حزمة إضافية من الطلبات السريعة.
انتقل إلى إعدادات فوترة Cursor وقم بتمكين تسعير الاستخدام.
راجع تكلفة الطلب الواحد (حالياً 0.04 دولار لكل طلب ل Claude 3.5).
هذا مفيد بشكل خاص للمستخدمين الذين يحتاجون إلى وصول متسق دون قيود صارمة.
إذا لم يعمل أي شيء... انتظر وأعد المحاولة
عادة ما يتم تطبيق حدود المعدل على أساس كل دقيقة، ساعة، أو يوم. إذا كنت قد تجاوزت حصتك، فقد تكون الحل الوحيد هو الانتظار حتى يتم إعادة تعيين نافذة الوقت التالية.
يمكن أن يقوم Cursor أحيانًا بتوليد العديد من الطلبات في فترة زمنية قصيرة—خاصةً مع ميزات مثل الإكمال التلقائي، واقتراحات الترميز المضمنة، أو وظيفة طرح السؤال. حاول تقليل استخدام هذه الميزات أو توزيع تفاعلاتك لتجنب حدود المعدل.
بالإضافة إلى ذلك، ضع في اعتبارك إيقاف الميزات التلقائية مؤقتًا في الإعدادات إذا كنت قريبًا من حدود الاستخدام.
الخاتمة
خطأ "تجاوز حد معدل مفتاح API المقدم من المستخدم" في Cursor AI هو إشارة إلى أن مفتاح API المتصل بك قد استنفد استخدامه المسموح به. هذه ليست خطأ ناجمة عن Cursor نفسها ولكن من قبل مزود API (OpenAI أو Anthropic) الذي يفرض حدود المعدل الخاصة بهم.
في معظم الحالات، تكون الحلول بسيطة: راجع استخدامك الحالي، أضف وسيلة دفع، أو انتقل إلى نموذج فوترة قائم على الاستخدام. كما تقدم Cursor مرونة من خلال مفاتيحها المدمجة وخيارات النماذج المتعددة لمساعدتك في تجاوز الازدحامات في الاستخدام.
لتعلم المزيد أو متابعة تجارب المجتمع، راجع خيط المنتدى النشط لـ Cursor حول هذه المشكلة.
من خلال فهم وإدارة استخدامك لـ API بشكل فعال، يمكنك ضمان إنتاجية غير مقطوعة مع Cursor AI ونماذج لغتك المفضلة.