cursorapikey.com/الدليل
مفاتيح API في Cursor لا تعمل: إصلاحات نقطة النهاية المخصصة
عندما لا تعمل مفاتيح API في Cursor، فإن السبب يكون تقريبًا دائمًا أحد أربعة أشياء: عنوان URL الأساسي، واسم النموذج، والمفتاح نفسه، أو حد على الحساب. يخبرك أمر curl واحد بالمشكلة.
تم التحديث


نقاط رئيسية
- اختبر المفتاح خارج Cursor أولاً باستخدام curl؛ إذا نجح curl، فإن المشكلة في إعدادات Cursor.
- يجب أن يكون عنوان URL الأساسي هو https://api.cursorapikey.com/v1 ويجب أن يكون اسم النموذج uncensored بالضبط.
- يعني 401 مفتاحًا سيئًا، و404 عنوان URL سيئًا، و429 حد معدل أو حد الطلبات المتزامنة، وخطأ في النموذج يعني اسمًا خاطئًا.
- تتغير تسميات القوائم بين إصدارات Cursor، لذا طابق غرض الحقل بدلاً من النص الدقيق.
الخطوة 1: اختبار المفتاح خارج Cursor
أخرج Cursor من الصورة. إذا نجح الطلب العادي، فإن مفتاحك وحسابك على ما يرام والخطأ في إعدادات المحرر. إذا فشل، فإن جسم الخطأ يحدد المشكلة.
curl -i https://api.cursorapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'
يطبع الخيار -i سطر الحالة والرؤوس. يعني حالة 200 مع مصفوفة choices النجاح. يُظهر الرأس X-Balance-USD رصيدك المتبقي، وهو أول شيء يجب التحقق منه إذا حصلت على خطأ في المصادقة أو الدفع.
يمكنك أيضًا سرد النماذج، مما يؤكد المفتاح دون إنفاق أي شيء:
curl https://api.cursorapikey.com/v1/models -H "Authorization: Bearer YOUR_KEY" | grep uncensored
يجب أن تحتوي الاستجابة على معرف النموذج uncensored.
الخطوة 2: تعيين الحقول في Cursor
افتح إعدادات Cursor وابحث عن قسم النماذج. تحتاج إلى ثلاث قيم، وأي خطأ في أي منها ينتج عنه فشل يبدو وكأن مفتاحك معطوب.
- مفتاح OpenAI API: الصق مفتاحك بدون مسافات أو فواصل أسطر في أي من الطرفين.
- تجاوز عنوان URL الأساسي لـ OpenAI: فعّل التجاوز وأدخل
https://api.cursorapikey.com/v1. احتفظ بـ/v1وأزل/chat/completions. - نموذج مخصص: أضف نموذجًا باسم
uncensoredوقم بتعطيله. عطّل النماذج التي لا تستخدمها حتى لا يختار Cursor نموذجًا لا تعرفه نقطة النهاية.
بعد الحفظ، استخدم خيار التحقق إذا كانت نسختك تحتوي عليه، ثم اختر uncensored في القائمة المنسدلة لنموذج الدردشة. تعد علامة تبويب الدردشة الجديدة اختبارًا جيدًا، لأن علامة التبويب القديمة قد تحتفظ بالنموذج الذي بدأت به. يُظهر الدليل خطوة بخطوة في كيفية استخدام API الخاص بـ Cursor نفس الإعداد مع المزيد من السياق.
مطابقة الخطأ مع الحل
| ما تراه | السبب المحتمل | الحل |
|---|---|---|
| 401، "مفتاح غير صالح"، "غير مصرح" | المفتاح مُدخل بشكل خاطئ، أو مُقتطع، أو مُلغى | انسخه مرة أخرى من صفحة المفتاح؛ تحقق من وجود مسافات لاحقة |
| 404، "غير موجود" | عنوان URL خاطئ، أو مفقود المسار /v1، أو مسار مكرر | استخدم بالضبط https://api.cursorapikey.com/v1 |
| "النموذج غير موجود" أو ما شابه | اسم النموذج يختلف عن uncensored | أضف النموذج المخصص بهذا الاسم بالضبط، بحروف صغيرة |
429 مع rate_limited | تجاوز حدّ الطلبات في الدقيقة | أبطئ؛ تسمح المفاتيح التجريبية بـ 60 طلب في الدقيقة، والمفاتيح الكاملة بـ 300 |
429 مع concurrency | عدد كبير من الطلبات في آن واحد | قلل من تشغيل الوكلاء المتوازيين؛ الحد للتجربة 2، وللمفتاح الكامل 8 |
429 مع Retry-After: 5 | إحمال مؤقت | انتظر خمس ثوانٍ ثم أعد المحاولة |
| يعمل في curl، يفشل في Cursor | الإعداد لم يُحفظ، أو النموذج المختار في علامة التبويب خاطئ، أو ميزة لا تستخدم المفاتيح المخصصة | راجع القسم التالي |
الطلبات الفاشلة أو المرفوضة لا تُفرض عليها رسوم، لذا فإن إعادة المحاولة أثناء تصحيح الأخطاء لا تكلف شيئًا.
عندما يعمل curl ولكن Cursor لا يزال يفشل
هذه هي الحالة الأكثر إرباكًا، ولها بعض التفسيرات المعتادة.
تم اختيار النموذج الخاطئ. يحتفظ Cursor بنماذجه المدمجة الخاصة به في القائمة. إذا تم اختيار أحد هذه النماذج، فإن الطلب لا يذهب إلى نقطة النهاية الخاصة بك على الإطلاق. حدد uncensored صراحةً في القائمة المنسدلة للدردشة أو المكون الذي تستخدمه.
لا تستخدم كل الميزات مفتاحك. الميزات التي تعتمد على نماذج Cursor الخاصة، مثل الإكمال التلقائي المضمن، قد تستمر في استخدامها بغض النظر عن المفتاح الذي تضيفه. تنطبق المفاتيح المخصصة في الأماكن التي يمكنك فيها اختيار النموذج، وهي أوضاع الدردشة والتحرير. تحقق من وثائق Cursor الحالية، لأن ذلك يتغير بين الإصدارات.
الطلبات المتزامنة من وضع الوكيل. يمكن للوكيل وتشغيل الخطوات المتعددة إطلاق عدة طلبات في وقت واحد. يسمح مفتاح التجربة بطلبين في الوقت نفسه. إذا ظهرت الأخطاء فقط في وضع الوكيل، فأنت على الأرجح تضرب حدّ concurrency، ويرفع المفتاح الكامل الحد إلى ثمانية. يحمل الطلب المتدفق مقعده حتى ينتهي البث المتدفق، لذا تشغل المخرجات الطويلة المقاعد لفترة أطول.
استدعاءات الأدوات. تدعم API استدعاء الأدوات، مع تدفق tool_calls وإرجاع النتائج كـ role: "tool". جودة استخدام الأدوات تعتمد على النموذج، لذا إذا تعثرت تشغيل الوكيل في خطوة أداة، حاول تنفيذ المهمة نفسها في الدردشة العادية أولاً.
فحص جانب الحساب
إذا أعاد curl خطأً يتعلق بالرصيد، فالمفتاح صالح لكن الرصيد فارغ أو انتهت الفترة التجريبية. تبلغ قيمة الفترة التجريبية $0.50، وهي صالحة لمدة 7 أيام، ويمكن الحصول عليها بنقرة واحدة في صفحة مفتاح API بعد تسجيل الدخول. بعدها تحتاج إلى شحن الرصيد.
شحن الرصيد يكون بأي مبلغ صحيح من $20 إلى $500، مع إضافة +5% من $50، و+10% من $100، و+15% من $200. يمكنك الدفع بالعملات المشفرة (USDT على TRC20، USDC على Base). يعرض صفحة الأسعار الجدول. إذا لم يكن لديك مفتاح بعد، احصل عليه من هنا.
احتفظ بمفتاح واحد لكل أداة. إذا ألصقت مفتاحاً في عدة محررات وسكربتات، فإن حدّ المعدل يكون مشتركاً بينها، مما قد يبدو كفشل عشوائي.
فحص السكربت للحالة العنيدة
إذا لم تتمكن من العثور على السبب بعد، شغّل سكربت قصير يماثل ما يفعله المحرر. يستخدم السكربت SDK الخاص بـ OpenAI، الذي تُصمَّم عليه عملاء بأسلوب Cursor، ويطبع كائن الخطأ الدقيق.
from openai import OpenAI, APIStatusError
client = OpenAI(base_url="https://api.cursorapikey.com/v1", api_key="YOUR_KEY")
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write a one-line Python hello world."}],
stream=True,
)
for chunk in r:
print(chunk.choices[0].delta.content or "", end="")
except APIStatusError as e:
print(e.status_code, e.response.headers.get("X-Request-Id"))
print(e.response.text)
إذا بثّ السكربت النص، فإن نقطة النهاية والمفتاح والنموذج صحيحان، والمشكلة المتبقية هي إعداد في Cursor. إذا طبع رمز حالة، استخدم الجدول أعلاه. احتفظ بقيمة X-Request-Id عند التواصل مع الدعم، لأنها تحدد الطلب الدقيق. التفاصيل الكاملة للمعاملات موجودة في صفحة التوثيق.
منع تكرار المشكلة
بعض العادات تمنع معظم المشاكل المتكررة. احفظ المفتاح في مدخل واحد في مدير كلمات المرور وانسخ منه، بدلاً من سجلات الدردشة أو الملاحظات حيث تتسلل فواصل الأسطر. دوّن القيم الثلاث (Base URL، المفتاح، اسم النموذج) حتى تتمكن من إدخالها مرة أخرى بعد تحديث المحرر، لأن التحديثات أحياناً تعيد تعيين التعديلات. بعد كل تحديث، أرسل رسالة دردشة قصيرة واحدة قبل بدء العمل الفعلي.
راقب الرصيد. يُعاد رأس X-Balance-USD في كل استجابة، ويمكنك أيضاً قراءته عبر GET /v1/balance. الرصيد لا ينتهي، لذا فإن الشحن المتواضع المودع في الحساب لا يضيع. إذا كنت تستخدم المفتاح من النصوص البرمجية ومن المحرر أيضاً، امنح مهام الدفع الكبيرة حلقة إعادة محاولة تنتظر خمس ثوانٍ عند استجابة 429 وتتوقف بعد محاولات قليلة، حتى لا تستهلك النص البرمجي فتحات التوازي الخاصة بمحررك.
فحص التكلفة وما يجب قراءته بعد ذلك
تطلب رسالة دردشة برمجية تحتوي على 10,000 رمز من سياق الملف وإجابة بـ 700 رمز: 10,000 / 1,000,000 × $0.15 = $0.0015 للإدخال، و700 / 1,000,000 × $0.50 = $0.00035 للإخراج، أي حوالي $0.00185 في المجموع. الأسعار هي $0.15 لكل مليون رمز إدخال و$0.50 لكل مليون رمز إخراج. يغطي المقال على أسعار API الخاص بـ Cursor التقديرات الشهرية.
إذا كان الطلب الذي فشل طلباً كبيراً، تذكر نافذة السياق: يجب أن يتسع الموجّه بالإضافة إلى الإكمال في 100,000 رمز، ويقتصر حجم جسم الطلب على 8 MB. إرفاق مستودع كامل بدردشة قد يتجاوز كلاهما. قلص السياق إلى الملفات ذات الصلة وحاول مرة أخرى.
المزيد من الأدلة
أسئلة وأجوبة
لماذا يقول Cursor إن مفتاح API الخاص بي غير صالح؟
عادةً يحتوي المفتاح على مسافة زائدة أو تم نسخه جزئياً، أو أن Base URL لا يزال يشير إلى خدمة أخرى. انسخ المفتاح مرة أخرى، ثم أكد أن URL التعديل هو https://api.cursorapikey.com/v1.
ما اسم النموذج الذي أدخله؟
أدخل uncensored، بحروف صغيرة. إنه معرف النموذج الوحيد الذي تقدمه API.
هل يستخدم الإكمال التلقائي مفتاحي؟
ليس بالضرورة. تستخدم بعض ميزات Cursor نماذجها الخاصة، وتطبق المفاتيح المخصصة بشكل أساسي على وضعي الدردشة والتعديل حيث تختار النموذج.
هل تُفرض رسوم على الطلبات الفاشلة؟
لا. الطلبات الفاشلة أو المرفوضة لا تُفرض عليها رسوم، لذا فإن إعادة المحاولة أثناء التصحيح لا تكلف شيئًا.
مفتاحك على بُعد استمارة واحدة
أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذه هي الإعدادات الكاملة.