كيفية استخدام مفتاح GitHub Copilot API مع Cursor API

فهم توافق مفتاح API

عندما يشير المطورون إلى github copilot api key، فإنهم عادةً ما يشيرون إلى رمز تم توليده داخل نظام Microsoft GitHub البيئي. يصادق هذا المفتاح على الطلبات المرسلة إلى خوادم Microsoft التي تشغل نماذج مثل GPT-4o أو متغيرات متخصصة مُحسّنة للشيفرة. على الرغم من قوة هذه النماذج، إلا أنها تأتي مع فلاتر محتوى محددة وحدود معدل مرتبطة بحسابك في Microsoft.

على النقيض من ذلك، يعمل Cursor API كخدمة مستقلة. لا يعتمد على بنية Microsoft التحتية. بدلاً من ذلك، يقدم نموذج لغة كبير مفتوح الأوزان واحدًا محسّنًا لسياقات البرمجة. صُمم هذا النموذج للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين، مما يجعله بديلاً مميزًا للمطورين الذين يجدون المرشحات القياسية مقيدة.

يعد فهم هذا التمييز أمرًا بالغ الأهمية. لن يعمل مفتاح GitHub Copilot API الحالي الخاص بك مع نقطة نهاية Cursor API. تحتاج إلى مفتاح منفصل تم إنشاؤه من حسابك على cursorapikey.com. ومع ذلك، يظل البروتوكول الأساسي نفسه، مما يعني أن الكود الخاص بك لا يحتاج إلى تغيير كبير.

تكوين البيئة

لاستخدام API Cursor، تحتاج أولاً إلى إنشاء مفتاح. سجّل حسابك في صفحة Get API key باستخدام البريد الإلكتروني وكلمة المرور فقط. لا حاجة لبطاقة ائتمان للحصول على رصيد تجريبي مجاني مبدئي. بمجرد التسجيل، يظهر المفتاح على الفور. احفظ هذا المفتاح بأمان في متغيرات البيئة، وعادةً باسم OPENAI_API_KEY أو متغير مخصص حسب متطلبات الوكيل الخاص بك.

تعتمد معظم وكلاء البرمجة، بما في ذلك Cursor والأدوات المشابهة، على معيار OpenAI SDK. هذا يعني أنك لا تحتاج إلى مكتبة مخصصة. تحتاج فقط إلى توجيه SDK الخاص بك إلى عنوان URL الأساسي الصحيح. عنوان URL الأساسي لـ Cursor API هو https://api.cursorapikey.com/v1. هذه النقطة متوافقة تمامًا مع OpenAI، وتدعم هياكل الطلبات نفسها التي أنت معتاد عليها.

تأكد من تكوين بيئتك لإرسال الطلبات إلى عنوان URL الأساسي الجديد. معرف النموذج الذي يجب عليك تحديده في طلباتك هو uncensored. يخبر هذا الـ API أي نموذج محدد سيتم استدعاؤه. إنه نموذج مفتوح الأوزان يعمل على خوادم GPU الخاصة بنا، وهو مختلف عن GPT أو Claude أو Gemini.

تبديل عناوين URL الأساسية

يتضمن التبديل من مفتاح github copilot api إلى Cursor API بشكل أساسي تغيير عنوان URL الأساسي في تكوين العميل. إذا كنت تستخدم SDKs الرسمية لـ Python أو Node.js لـ OpenAI، فهذا تغيير في سطر واحد. على سبيل المثال، في Python، ستقوم بتهيئة العميل بعنوان URL الجديد ومفتاح API الجديد.

يؤدي هذا التغيير إلى إعادة توجيه طلباتك من خوادم Microsoft إلى بنيتنا التحتية. تشمل الميزات الوصول إلى نافذة سياق بحجم 100,000 رمز (token) ونموذج مُضبط لرفض أقل. يمكنك التحقق من الاتصال عن طريق التحقق من نقطة /v1/models، والتي يجب أن تُرجع النماذج المتاحة، بما في ذلك uncensored.

Trade-off: على الرغم من تطابق البنية، فإنك تدفع الآن مقابل كل رمز بدلاً من الاشتراك الشهري في Microsoft. أسعارنا شفافة: $0.25 لكل مليون رمز مدخل و$1.00 لكل مليون رمز مخرج. لا توجد رسوم شهرية، فقط رصيد حسب الاستخدام لا ينتهي. هذا النموذج مثالي للأحمال المتغيرة حيث لا ترغب في الالتزام بتكلفة مقعد شهري.

اختبار الاتصال الخاص بك

قبل دمج API في سير عملك الرئيسي، من الضروري التحقق من قدرة بيئتك على التواصل مع Cursor API. يمكنك القيام بذلك باستخدام أمر cURL بسيط أو نص قصير. يضمن هذا الاختبار أن مفتاحك صالح وعنوان URL الأساسي صحيح.

مثال طلب cURL:

أرسل طلب POST إلى https://api.cursorapikey.com/v1/chat/completions مع تعيين النموذج إلى uncensored. قم بتضمين موجّه بسيط في مصفوفة الرسائل. ستعيد الاستجابة الناجحة إكمالًا في حقل choices[0].message.content.

إذا تلقيت خطأ 401، فإن مفتاح API الخاص بك غير صحيح. إذا حصلت على خطأ 429، فقد تجاوزت حدّ المعدل البالغ 300 طلب في الدقيقة لكل مفتاح. يمكنك إعادة إنشاء مفتاحك في أي وقت لإبطال المفتاح القديم. يؤكد هذا الاختبار أن وظيفة النص المدخل/المخرج الأساسية تعمل كما هو متوقع.

التعامل مع الاستجابات المتدفقة

بالنسبة لوكلاء البرمجة، تعد الاستجابات المتدفقة أمرًا حاسمًا لتوفير تجربة مستخدم سلسة. يدعم Cursor API أحداث Server-Sent (SSE) للبث المتدفق. يتيح ذلك لك استلام الرموز (token) عند توليدها، بدلاً من الانتظار للحصول على الاستجابة الكاملة.

عند استخدام مكتبة OpenAI SDK، يمكنك تفعيل البث المتدفق عن طريق تعيين المعلمة stream إلى true. سيقوم الـ SDK بإرجاع أجزاء من البيانات عند وصولها. هذا مفيد بشكل خاص لتوليد الشيفرات الطويلة، حيث تريد عرض التقدم للمستخدم أو تغذية الرموز في محرر مباشر.

ضع في اعتبارك أن البث المتدفق لا يغير النموذج الأساسي أو قدراته. إنه مجرد آلية توصيل. لا يزال النموذج uncensored يلتزم بنافذة سياق 100,000 رمز وهيكل التسعير نفسه. البث المتدفق ميزة على جانب العميل تحسن زمن الاستجابة المدرك دون التأثير على سلوك النموذج.

تكامل استدعاء الدوال

تعتمد مساعدي البرمجة AI الحديثة بشكل كبير على استدعاء الدوال (function calling) للتفاعل مع العالم الخارجي، مثل تشغيل أوامر وحدة التحكم أو الوصول إلى الملفات. يدعم Cursor API هذا عبر التنسيق القياسي المتوافق مع OpenAI.

يمكنك تعريف الأدوات في طلبك باستخدام المعلمة tools. سيعيد النموذج مصفوفة tool_calls إذا قرر أنه يجب استخدام أداة. يجب على تطبيقك بعد ذلك تنفيذ الأداة وإرسال النتائج مرة أخرى إلى الـ API في رسالة لاحقة.

هذه العملية مطابقة لكيفية استخدام github copilot api key مع نماذج Microsoft. الميزة هنا هي الاتساق. إذا كان لديك شيفرة موجودة لاستدعاء الدوال، فيمكنك على الأرجح إعادة استخدامها مع تعديلات قليلة. فقط تأكد من مطابقة تعريفات الأدوات للمخطط المتوقع لنموذج uncensored.

تتبع الاستخدام

بما أنك تدفع مقابل كل رمز (token)، فإن تتبع استخدامك مهم لتجنب التكاليف غير المتوقعة. يوفر Cursor API لوحة تحكم حيث يمكنك عرض رصيد الرصيد وسجل الاستخدام. يمكنك رؤية عدد الرموز (token) التي استهلكتها وكم رصيد متبقي.

حدود رئيسية يجب مراقبتها:

• حدّ المعدل: 300 طلب في الدقيقة لكل مفتاح.
• حجم جسم الطلب: الحد الأقصى 8 MB لكل طلب.
• نافذة السياق: 100,000 رمز (token) إجماليًا (إدخال + إخراج).

إذا تجاوزت حدّ المعدل، فستحصل على خطأ 429. يمكنك مراقبة استخدامك في الوقت الفعلي للتأكد من بقائك ضمن هذه الحدود. بالإضافة إلى ذلك، يمكنك إعادة إنشاء مفتاح API الخاص بك إذا اشتبهت في تعرضه للاختراق، مما يبطل المفتاح القديم على الفور.

استكشاف الأخطاء الشائعة وإصلاحها

حتى مع API قوي، يمكن أن تظهر المشكلات. إليك بعض المشكلات الشائعة وحلولها.

401 غير مصرح: تحقق من مفتاح API الخاص بك. تأكد من نسخه بشكل صحيح ولا توجد مسافات بادئة أو لاحقة. إذا قمت بإعادة إنشاء مفتاحك، فتأكد من استخدام المفتاح الجديد.

429 Too Many Requests: لقد تجاوزت حد 300 طلب في الدقيقة. نفّذ التراجع الأسي في العميل الخاص بك أو قلل من وتيرة طلباتك.

400 طلب غير صالح: يشير هذا عادةً إلى حمولة JSON غير صحيحة أو حقول مطلوبة مفقودة. تأكد من أن مصفوفة messages الخاصة بك مُنسقة بشكل صحيح وتتضمن حقلي role وcontent. أيضًا، تحقق من أن اسم النموذج هو بالضبط uncensored.

Content Blocking: على الرغم من أن النموذج غير خاضع للرقابة، إلا أنه يمنع محتوى الجنس الذي يتضمن قاصرين. إذا تم حظر طلبك، فقد يكون ذلك بسبب هذا الحد الصارم المحدد.