ما تقوم بإعداده
Cursor هو محرر يدعم مزودي نماذج مخصصين. إذا زودته بعنوان URL أساسي على نمط OpenAI ومفتاح واسم نموذج، فسيتم إرسال طلبات الدردشة الخاصة به إلى هناك بدلاً من مزودها الافتراضي. هذه الخدمة تتحدث بروتوكول: POST /v1/chat/completions مع مصادقة Bearer، بالإضافة إلى GET /v1/models.
شيئان يجب أن تكون واضحًا بشأنهما منذ البداية. هذه API مستقلة تشغل نموذجًا مفتوح الأوزان، وليست Codex الخاصة بـ OpenAI وليست منتجًا رسميًا من Cursor. وتتغير شاشات الإعدادات في Cursor غالبًا، لذا قد تظهر التسميات أدناه في مكان مختلف قليلاً في إصدارك. القيم الثلاث لا تتغير أبدًا: عنوان URL الأساسي، والمفتاح، واسم النموذج.
الخطوة 1: احصل على مفتاح واختبره خارج Cursor
سجّل حسابًا في صفحة مفتاح API باستخدام Google أو عبر البريد الإلكتروني وكلمة المرور. يمكن للحسابات الجديدة المطالبة برصيد تجريبي مجاني بقيمة $0.50 بنقرة واحدة، صالح لمدة 7 أيام، دون الحاجة إلى بطاقة. وهذا يكفي لاختبار إعداد المحرر.
قبل لمس إعدادات Cursor، تأكد من أن المفتاح يعمل. فشل داخل محرر أصعب في القراءة من فشل في طرفية (terminal).
curl https://api.getcodexapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a Python function that reverses a string."}]
}'إذا حصلت على رد JSON يحتوي على كود، فانتقل إلى الخطوة التالية. وإذا حصلت على خطأ، فأصلحه هنا أولاً. الأسباب الشائعة هي حرف مفقود في المفتاح أو مسافة ملصقة في النهاية.
الخطوة 2: تكوين Cursor
- افتح إعدادات Cursor وانتقل إلى قسم النماذج.
- ابحث عن حقل مفتاح API الخاص بـ OpenAI والصق مفتاحك من هذه الخدمة.
- فعّل خيار تجاوز عنوان URL الأساسي لـ OpenAI، وأدخل
https://api.getcodexapi.com/v1. - أضف نموذجًا مخصصًا واكتب الاسم الدقيق
uncensored. - شغّل زر التحقق إذا كان موجودًا، ثم افتح لوحة الدردشة واختر
uncensoredمن قائمة النماذج.
إذا أبلغت خطوة التحقق عن فشل، فافحص ثلاثة أشياء بالترتيب: أن يكون عنوان URL الأساسي ينتهي بـ /v1 بدون مسار نقطة نهاية بعده، وأن يكون المفتاح قد لُصق بدون مسافات بيضاء لاحقة، وألا يحتوي اسم النموذج على أحرف كبيرة. تذكر صفحة التوثيق القيم نفسها مع أمثلة إضافية للعميل.
شيء واحد يجب التخطيط حوله: التجاوز هو إعداد، وليس خيارًا لكل نموذج، لذا إذا كنت تستخدم أيضًا مفتاح OpenAI الخاص بك في مكان آخر في Cursor، فقم بإيقاف التجاوز أولاً. احتفظ بملاحظة لما قمت بتغييره.
بعد الحفظ، اطرح سؤالًا برمجيًا بسيطًا على النموذج في الدردشة وراقب الرد. يعد بطء الإجابة الأولى أمرًا طبيعيًا بينما يبني Cursor طلبه. إذا عادت الإجابة، فأنت متصل، والخطوة التالية هي تجربتها على عمل حقيقي في مستودعك الخاص.
ما الذي سيمر عبر مفتاحك وما الذي لن يمر
يخلط Cursor بين عدة ميزات. طلبات الدردشة والتحرير المضمنة هي الأكثر احتمالًا لاستخدام النموذج المخصص الخاص بك بمجرد اختياره. الميزات الأخرى، مثل إكمال التاب (tab completion)، استخدمت تاريخيًا نماذج يشغلها Cursor بنفسه، وقد تعتمد ميزات الأسلوب الوكيل (agent-style) على كيفية تعامل Cursor مع الأدوات. الطريقة الصادقة لمعرفة ذلك هي تجربة الميزة التي تعتمد عليها ومراقبة رصيدك.
هذا سهل القيام به: يحمل كل رد من هذه الواجهة API رأس X-Balance-USD، ورصيدك مرئي في حسابك. إذا أرسلت رسالة دردشة ولم يتغير الرصيد، فهذا الطلب لم يصل إلينا.
استدعاء الدوال مدعوم في نقطة النهاية هذه (tools، tool_choice، البث المتدفق لـ tool_calls، والنتائج بصيغة role: "tool")، وهو ما تحتاجه وكلاء المحرر. يعمل البث المتدفق عبر أحداث الخادم المرسلة (SSE) مع stream: true. نافذة السياق هي 100,000 رمز، للموجّه والإكمال معاً، لذا فإن ملفًا كبيرًا بالإضافة إلى جيرانه يتسع لطلب واحد.
لماذا استخدام نموذج بدون رقابة في محرر
معظم أعمال البرمجة لا تواجه رفضًا. عندما يحدث ذلك، فإنه يميل لأن يكون لمهام مشروعة تبدو خطيرة على مرشح حذر: كتابة ماسح منافذ لشبكتك الخاصة، تحليل عينات البرمجيات الخبيثة التي تقوم بدراستها، توليد بيانات اختبار تتضمن لغة مسيئة، بناء الواجهة الخلفية لتطبيق لعب أدوار أو تطبيق مرافقة للبالغين، أو إعادة هيكلة كود يتعامل مع مراقبة المحتوى. هذا النموذج مُعد للإجابة بدون رفضات محتوى للاستخدام القانوني للبالغين.
لا يزال نموذجًا عامًا مفتوح الأوزان، وليس نموذج برمجة متخصصًا، ولا شيء هنا يضمن أنه يتفوق على أي بديل معين في قاعدة الكود الخاصة بك. قم بتشغيل مهامك الخاصة من خلاله. قاعدة واحدة ثابتة: لا محتوى جنسي يتضمن قاصرين، ولا يمكن تغيير ذلك.
ما يكلفه عمليًا
التسعير هو $0.15 لكل مليون رمز مدخل و$0.50 لكل مليون رمز مخرج، من رصيد مسبق الدفع بدون اشتراك. حركة المرور في المحرر ثقيلة من جهة الإدخال، لأن كل طلب يعيد إرسال سياق الملف.
طلب يحتوي على 8,000 رمز إدخال و 1,000 رمز إخراج يكلف 8,000 × $0.15 / 1,000,000 = $0.0012 للإدخال، بالإضافة إلى 1,000 × $0.50 / 1,000,000 = $0.0005 للإخراج، وهو ما مجموعه $0.0017. إذا قمت بـ 150 من تلك الطلبات في يوم حافل، فهذا يساوي 150 × $0.0017 = $0.255، أي حوالي 26 سنتاً.
طلب يرسل 40,000 رمز سياق ويعيد 1,500 يكلف $0.006 + $0.00075 = $0.00675. تبدأ عمليات شحن الرصيد بمبلغ $20 ولا تنتهي صلاحية الرصيد، لذا لا يوجد ضغط لاستهلاكه. انظر صفحة التسعير للحصول على مستويات المكافآت، وصفحة واجهة برمجة التطبيقات للبرمجة للحصول على نظرة عامة.
حدود المعدل لاستخدام المحرر
المفتاح الكامل يسمح بـ 8 طلبات متزامنة و300 طلب في الدقيقة. المفتاح التجريبي يسمح بـ 2 متزامن و60 في الدقيقة. نادراً ما يقترب شخص واحد يكتب في محرر واحد من أي منهما، لكن فريقًا يشارك مفتاحًا واحدًا، أو وكيلًا يطلق العديد من الطلبات بالتزامن، يمكنه ذلك. عندما تتجاوز الحدود، تُعيد الـ API استجابة HTTP 429. يعني الرمز rate_limited طلبات كثيرة جدًا في الدقيقة، وconcurrency تعني طلبات كثيرة جدًا في نفس الوقت. إذا كانت الخدمة مثقلة مؤقتًا، فإنك ترى أيضًا 429 مع Retry-After: 5.
تحتفظ الدردشة المتدفقة بخانة التزامن الخاصة بها حتى ينتهي البث. للاستخدام المشترك، امنح كل مطور مفتاحه الخاص بدلاً من مفتاح واحد للفريق.
قائمة استكشاف الأخطاء
- النموذج غير موجود. أعد كتابة
uncensoredبدون مسافات. أزل النماذج المخصصة القديمة التي لا تستخدمها. - خطأ في المصادقة. أعد نسخ المفتاح. تأكد من أن Cursor لا يزال يستخدم مفتاحاً من مزود آخر.
- تتوقف الردود مبكرًا. تحقق مما إذا كان Cursor يحدد حدًا للإخراج الخاص به. من جانبنا،
max_tokensاختياري. - لا شيء يتغير في رصيدك. الميزة التي استخدمتها لا يتم توجيهها عبر مفتاحك المخصص. جرب الدردشة بدلاً من ذلك.
- 429 متكرر. قلل الطلبات المتزامنة، أو استخدم مفتاحًا كاملاً بدلاً من مفتاح تجريبي.
