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

نقاط رئيسية
- يسمح Cursor لك بتجاوز عنوان URL الأساسي لـ OpenAI والمفتاح، بحيث يمكن لأي نقطة نهاية متوافقة مع OpenAI خدمة الطلبات.
- استخدم عنوان URL الأساسي https://api.cursorapikey.com/v1 ومعرف النموذج
uncensored. - اختبر المفتاح باستخدام curl قبل لمس المحرر، لتعرف من أي جانب يأتي الفشل.
- يكلف الموجّه الذي يحتوي على 20,000 رمز والإجابة التي تحتوي على 1,000 رمز $0.0035.
يغطي هذا الدليل
الأشخاص الذين يبحثون عن كيفية استخدام Cursor API يقصدون عادةً أحد أمرين. إما أنهم يريدون استدعاء خدمة Cursor من الكود، أو يريدون محرر Cursor إرسال طلبات النموذج الخاصة به إلى نقطة نهاية يختارونها. هذا الدليل يتعلق بالحالة الثانية. هذا الموقع هو API مستضاف مستقل يتحدث بروتوكول إكمال الدردشة الخاص بـ OpenAI، لذا يمكن لـ Cursor التحدث معه بنفس الطريقة التي يتحدث بها مع أي خادم على طراز OpenAI.
النموذج وراءه هو نموذج مفتوح الأوزان واحد، يشغله مزود مستقل ومضبط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين. إنه ليس نموذج Cursor الرسمي، وليس موجّهًا بين المزوّدين. يتعامل مع النصوص فقط. للبرمجة، هذا عادةً كافٍ: ترسل الكود والتعليمات، وتحصل على الكود والشرح.
تحتاج إلى ثلاثة أشياء: مفتاح API، عنوان URL الأساسي https://api.cursorapikey.com/v1، ومعرف النموذج uncensored. الباقي هو مسألة العثور على الحقول الصحيحة في المحرر.
الخطوة 1: احصل على مفتاح واختبره باستخدام curl
سجّل حسابك باستخدام Google أو عبر البريد الإلكتروني وكلمة المرور، ثم افتح صفحة مفتاح API. يمكن للحسابات الجديدة الحصول على رصيد تجريبي مجاني بقيمة $0.50 بنقرة واحدة. لا يتطلب الأمر بطاقة ويبقى ساريًا لمدة 7 أيام. مفتاح التجربة محدود بطلبين متزامنين و60 طلبًا في الدقيقة، وهو ما يكفي لجلسة أولية في محرر الأكواد.
قبل فتح Cursor، تأكد من أن المفتاح يعمل. شغّل الأمر التالي في الطرفية، مع وضع مفتاحك في متغير بيئة:
export API_KEY="paste-your-key-here"
curl https://api.cursorapikey.com/v1/models \
-H "Authorization: Bearer $API_KEY"
curl https://api.cursorapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Write a Python function that reverses a linked list."}
]
}'
الاستدعاء الأول يعرض قائمة بالنماذج. الاستدعاء الثاني يعيد إكمال محادثة عادي. إذا نجح الاثنان، فإن أي فشل لاحق في المحرر يكون مشكلة إعدادات وليس مشكلة في المفتاح. هذا الفصل يوفر الكثير من التخمين.
الخطوة 2: ضبط عنوان URL الأساسي والمفتاح في Cursor
افتح إعدادات Cursor وانتقل إلى قسم النماذج. تتغير أسماء القوائم والتخطيط بين الإصدارات، لذا تعامل مع التسميات أدناه كخريطة، وتحقق من وثائق Cursor الخاصة إذا انتقل أي شيء.
- ابحث عن حقل مفتاح OpenAI API والصق مفتاحك من هذا الموقع.
- فعّل خيار تجاوز عنوان URL الأساسي لـ OpenAI وأدخل
https://api.cursorapikey.com/v1. احتفظ بـ/v1في النهاية ولا تضيف/chat/completions؛ لأن تطبيق العميل يضيف المسار تلقائيًا. - أضف نموذجًا مخصصًا واكتب
uncensoredبالضبط، بحروف صغيرة. - استخدم زر التحقق أو الحفظ إذا كان المحرر يوفر ذلك، ثم حدد النموذج الجديد في لوحة الدردشة.
أرسل رسالة قصيرة مثل "اشرح هذه الدالة" مع فتح ملف. إجابة متدفقة تعني أن المسار يعمل من البداية للنهاية. يرسل Cursor الطلب، وتبث نقطة النهاية الرموز (tokens) مرة أخرى عبر SSE، ويعرضها المحرر مع وصولها.
تحذيران. بعض ميزات المحرر، مثل الإكمال التلقائي المضمّن عبر Tab، قد تعمل على نماذج يتحكم فيها Cursor وقد تتجاهل مفتاحك، لذا تحقق من الميزات التي تستخدم النموذج المخصص فعليًا. وبما أن Cursor قد يوجّه حركة المرور الخاصة بالمفاتيح المخصصة عبر خوادمه الخاصة، فاقرأ وثائقه الحالية إذا كنت بحاجة إلى معرفة مكان انتقال الكود بدقة. يدرج البدء السريع على هذا الموقع جانب API من العقد.
اختبر نقطة النهاية نفسها من الكود
أسهل طريقة لعزل المشكلة هي استدعاء نقطة النهاية باستخدام SDK الرسمي لـ OpenAI. إذا نجح ذلك، فإن نقطة النهاية تعمل بشكل صحيح وأي مشكلة متبقية تكمن في تكوين المحرر.
from openai import OpenAI
client = OpenAI(
api_key="paste-your-key-here",
base_url="https://api.cursorapikey.com/v1",
)
stream = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a terse senior engineer."},
{"role": "user", "content": "Refactor this loop into a list comprehension: out = []\nfor x in xs:\n if x > 0:\n out.append(x * 2)"},
],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
نفس الشيء في Node:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.API_KEY,
baseURL: "https://api.cursorapikey.com/v1",
});
const res = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a regex that matches ISO 8601 dates." }],
});
console.log(res.choices[0].message.content);
تتضمن الاستجابات المتدفقة معلومات الاستخدام في النهاية، مما يتيح لك تسجيل عدد الرموز التي استخدمها الطلب بدقة. كما تحمل كل استجابة رأس X-Balance-USD يحتوي على رصيدك المتبقي، ورأس X-Request-Id يمكنك الاستشهاد به إذا بدا أي شيء غير صحيح.
ما يعمل في سير عمل البرمجة
تدعم واجهة API البث المتدفق، ووضع JSON، واستدعاء الدوال (tools، tool_choice، وtool_calls المتدفق، والنتائج المرسلة كـ role: "tool"). تُمرَّر إعدادات أخذ العينات مثل temperature، top_p، stop، seed ومعاملات penalty كما هي. نافذة السياق هي 100,000 رمز، مشتركة بين الموجّه والإكمال، وmax_tokens اختياري.
هذه الـ 100,000 رمز (token) هي ميزانية سخية للكود. ملف المصدر الذي يحتوي على بضع مئات من الأسطر هو بضعة آلاف من الرموز (tokens)، لذا يمكنك تضمين عدة ملفات بالإضافة إلى تعليمات طويلة ولا يزال لديك مساحة للإجابة. الحد الأقصى لحجم جسم الطلب (body) هو 8 MB، وهو شيء لن تصل إليه مع النصوص.
بعض العادات التي تجعل النموذج المخصص ممتعًا في المحرر:
- حافظ على قيمة
temperatureمنخفضة لتعديلات الكود. تعطي القيم حول 0.2 مخرجات أكثر استقرارًا؛ ارفعها فقط لأجل العصف الذهني. - أرفق فقط الملفات ذات الأهمية. كل رمز (token) ترسله يتم احتسابه كمدخلات، ويتم إعادة إرسال المحادثة بأكملها في كل خطوة.
- اطلب diff أو الدالة المعدلة، وليس الملف بأكمله، عندما يكون الملف طويلاً. تكلف الرموز (tokens) الناتجة أكثر من الرموز (tokens) المدخلة.
- استخدم النموذج للمهام التي يعيقها الرفض، مثل كتابة نماذج استغلال (proof-of-concepts) لمختبرك الخاص، أو تحليل عينات البرمجيات الخبيثة المسموح لك بدراستها، أو توليد بيانات اختبار تحاكي محتوى العالم الحقيقي المزعج. كل ذلك يجب أن يكون قانونيًا.
الحد الصارم الوحيد الذي يستحق التكرار: لا محتوى جنسي يتضمن القاصرين، بأي صيغة كانت.
تصحيح الأخطاء الشائعة
| العرض | السبب المحتمل | الحل |
|---|---|---|
| 401 أو "مفتاح غير صالح" | تم لصق المفتاح مع وجود مسافة، أو مفتاح قديم | أعد النسخ من صفحة المفاتيح؛ واختبره باستخدام curl |
| خطأ 404 أو "النموذج غير موجود" | تم كتابة اسم النموذج بشكل مختلف | استخدم uncensored، بحروف صغيرة، بدون لاحقة |
| خطأ 404 في المسار | يحتوي عنوان URL الأساسي على /chat/completions | أنهِ عنوان URL الأساسي عند /v1 |
429 مع concurrency | عدد كبير من الطلبات في آن واحد | انتظر حتى تنتهي عمليات البث؛ المفتاح الكامل يسمح بـ 8، والمفتاح التجريبي بـ 2 |
429 مع rate_limited | أكثر من 300 طلب في الدقيقة (60 في فترة التجربة) | أبطئ، أو أعد المحاولة بعد توقف |
429 مع Retry-After: 5 | حمل زائد مؤقت | أعد المحاولة بعد خمس ثوانٍ |
يحتفظ الطلب المتدفق بمكانه في حدّ التوازي حتى ينتهي البث. إذا بدأت عدة محادثات في Cursor وتركتها تولد، فقد تصل بسرعة إلى حدّ التوازي في المفتاح التجريبي. الطلبات الفاشلة أو المرفوضة لا تُحسب، لذا فإن إعادة المحاولة لا تكلف شيئاً إضافياً.
تكلفة جلسة البرمجة
السعر هو $0.15 لكل مليون رمز مدخل و$0.50 لكل مليون رمز مخرج، يُخصم من رصيد مسبق الدفع بدون اشتراك. طلب المحرر النموذجي يحتوي على موجّه كبير (ملفاتك) وإجابة قصيرة. لنأخذ 20,000 رمز مدخل و1,000 رمز مخرج:
- مدخل: 20,000 × $0.15 / 1,000,000 = $0.0030
- مخرج: 1,000 × $0.50 / 1,000,000 = $0.0005
- المجموع: $0.0035 لكل طلب
عند 100 طلب في يوم عمل، يكلف ذلك $0.35. رصيد التجربة بقيمة $0.50 يغطي حوالي 140 طلبًا من هذا النوع. بعد انتهاء التجربة، يمكنك شحن أي مبلغ صحيح يتراوح بين $20 و$500، مع رصيد إضافي بنسبة +5% من مبلغ $50، و+10% من مبلغ $100، و+15% من مبلغ $200. ادفع بالعملات المشفرة فقط (USDT على شبكة TRC20، USDC على شبكة Base). الرصيد لا ينتهي، لذا فإن الشحن الذي تستخدمه ببطء لن يضيع. تحتوي صفحة التسعير على الجدول الكامل، وتشرح الصفحة الخاصة بـ بديل Cursor وCopilot أين ينتمي هذا ضمن محررات الاشتراك.
لا تُستخدم الموجّهات في التدريب.
المزيد من الأدلة
أسئلة وأجوبة
هل يعمل هذا مع وكيل Cursor واستدعاء الدوال؟
يدعم API استدعاء الدوال مع الأدوات وtool_choice وtool_calls المتدفقة. يعتمد ما إذا كانت ميزة Cursor معينة تستخدم النموذج المخصص الخاص بك على المحرر، لذا اختبر كل ميزة بعد الإعداد.
ما اسم النموذج الذي أدخله؟
أدخل uncensored، بحروف صغيرة. إنه معرف النموذج الوحيد، ويظهر في GET /v1/models.
هل هذه واجهة Cursor API الرسمية؟
لا. إنها واجهة برمجة تطبيقات متوافقة مع OpenAI ومستقلة، تعمل أمام نموذج مفتوح الأوزان. يسمح لك Cursor ببساطة بتوجيه إعدادات OpenAI الخاصة به إلى نقطة نهاية مختلفة.
هل أحتاج إلى بطاقة لتجربته؟
لا. يمكن الحصول على رصيد التجربة بقيمة $0.50 بنقرة واحدة في صفحة مفتاح API بعد التسجيل، ولا يتطلب بطاقة، وهو صالح لمدة 7 أيام.
مفتاحك على بُعد استمارة واحدة
أنشئ حساباً، وانسخ المفتاح، ثم غيّر عنوان URL الأساسي. هذا هو الإعداد كله.