كيفية استخدام DeepSeek API في Cursor: إعداد عنوان URL الأساسي المخصص

الإجابة المختصرة

إذا كنت تريد معرفة كيفية استخدام واجهة برمجة التطبيقات (API) الخاصة بـ deepseek في Cursor، فإن العملية هي نفسها لأي مزود متوافق مع OpenAI. تفتح إعدادات النموذج في Cursor، وتلصق مفتاح API في حقل مفتاح OpenAI، وتتجاوز عنوان URL الأساسي لـ OpenAI، وتضيف اسم نموذج لا يعرفه Cursor. ثم تختار هذا النموذج في الدردشة.

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

قبل فتح Cursor: احصل على مفتاح واختبره

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

الآن اختبر المفتاح خارج Cursor. رسائل الخطأ في Cursor قصيرة، وقد يبدو الخطأ المطبعي في المفتاح مشابهًا لخطأ في عنوان URL. قم بتشغيل هذا في طرفية:

Copycurl https://api.deepseekapi.top/v1/chat/completions   -H "Authorization: Bearer YOUR_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a Python function that reverses a string."}]
  }'

يجب أن تحصل على رد JSON يحتوي على الوظيفة في choices[0].message.content. يمكنك أيضًا سرد النماذج باستخدام GET /v1/models، وهي طريقة سريعة لتأكيد قبول المفتاح. إذا نجح هذا، فإن جانب نقطة النهاية مكتمل وكل ما تبقى هو إعدادات Cursor.

تكوين Cursor خطوة بخطوة

1. افتح إعدادات Cursor وانتقل إلى قسم النماذج. في معظم الإصدارات، يمكنك الوصول إليه عبر أيقونة الترس، ثم النماذج.
2. ابحث عن حقل مفتاح OpenAI API الخاص بك والصق المفتاح. قد يطلب منك Cursor التحقق منه. قد يفشل التحقق مع نقطة نهاية مخصصة، لأن Cursor يتحقق من المفتاح مقابل قائمته الخاصة من النماذج. إذا حدث ذلك، تابع الخطوات التالية وقم بالحكم بناءً على ما إذا كانت الدردشة تعمل.
3. فعّل خيار تجاوز عنوان URL الأساسي لـ OpenAI وأدخل https://api.deepseekapi.top/v1. أضف /v1 في النهاية. لا تضيف /chat/completions؛ لأن تطبيق العميل يضيف هذا المسار تلقائيًا.
4. استخدم عنصر التحكم لإضافة نموذج واكتب uncensored بالضبط، بحروف صغيرة. فعّله في قائمة النماذج.
5. افتح لوحة الدردشة، واختر uncensored من قائمة اختيار النموذج، وأرسل موجّهًا قصيرًا.

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

إعداد واحد يجب مراقبته

يحتفظ Cursor بتجاوز واحد فقط لعنوان URL الأساسي لـ OpenAI. أثناء تفعيله، ينتقل كل نموذج يحمل اسم OpenAI تستخدمه في Cursor إلى العنوان الجديد. إذا كنت تريد أيضًا استخدام خدمة متوافقة مع OpenAI مختلفة لشيء آخر، فقم بإيقاف التجاوز، أو استخدم ملف تعريف منفصل.

ما يعمل مع نقطة نهاية مخصصة

يُستخدم المفتاح المخصص للميزات التي تستدعي نموذج دردشة: لوحة الدردشة والتعديلات المضمنة. ترسل هذه الميزات طلب إكمال دردشة قياسي، وهو ما تقبله واجهة برمجة التطبيقات (API). تدعم الخدمة البث المتدفق عبر SSE، لذا تظهر الردود رمزًا تلو الآخر في لوحة الدردشة كما هو الحال مع المزودين الآخرين.

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

تعتمد الميزات على نمط الوكيل على استدعاء الدوال. تدعم واجهة برمجة التطبيقات استدعاء الدوال باستخدام tools، وtool_choice، وtool_calls المتدفق، مع إرجاع النتائج بصيغة role: "tool". قد يختلف ما إذا كان وضع Cursor معين يستخدم هذا المسار مع نموذج مخصص بين الإصدارات، لذا تعامل معه كشيء يجب اختباره على مهمة صغيرة قبل بناء سير عمل حوله.

نافذة السياق هي 100,000 رمز، الموجّه بالإضافة إلى الإكمال. هذا كبير بما يكفي لعدة ملفات في وقت واحد، لكن Cursor يقرر ما يجب إرفاقه، والإرفاق الكبير يكلف رموز المدخلات في كل رسالة.

الموجّهات التي تعمل بشكل جيد في محرر النصوص

نموذج الدردشة في محرر النصوص لا يكون مفيدًا إلا بقدر سياق البيانات الذي تزوده به. بعض العادات البسيطة تُحدث فرقًا ملحوظًا مع أي نموذج خلف نقطة نهاية مخصصة.

• أرفق فقط الملفات ذات الأهمية. كل ملف مرفق هو رموز مدخلات في كل دور. ملفان ذوو صلة يفوزان على عشرة ملفات ذات صلة ضعيفة، سواء من حيث الجودة أو التكلفة.
• حدد المهمة والقيود. "أعد كتابة هذه الدالة لتجنب الاستدعاء الذاتي، مع الحفاظ على التوقيع" يعمل بشكل أفضل من "اجعل هذا أفضل".
• اطلب إجابة بحجم diff. إذا كنت تريد تغييرًا صغيرًا، فاذكر ذلك. وإلا فقد يعيد النموذج كتابة الملف بأكمله، وستدفع مقابل رموز المخرجات.
• ابدأ دردشة جديدة لكل مهمة. الخطوات القديمة تُعاد إرسالها. الدردشة النظيفة هي أسهل طريقة لتقليل حجم السياق.

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

إذا تعثرت إجابة طويلة، تحقق من قسم حدود المعدل أدناه. ستملأ نافذتا محرر تبثان في وقت واحد على مفتاح تجريبي كلا خانتَي التزامن، وسينتظر الطلب الثالث أو يعيد رمز 429.

التكلفة في محرر النصوص

السعر هو $0.15 لكل مليون رمز مدخل و $0.50 لكل مليون رمز مخرج، من رصيد مسبق الدفع. لا توجد اشتراكات، الطلبات الفاشلة أو المرفوضة لا تُحسب، والرصيد لا ينتهي.

الدور النموذجي في الدردشة داخل محرر يحتوي على الكثير من المدخلات (الملف الذي أرفقته بالإضافة إلى السجل) وإجابة قصيرة. خذ 6,000 رمز مدخلات و700 رمز مخرجات:

• المدخلات: 6,000 × $0.15 / 1,000,000 = $0.0009
• المخرجات: 700 × $0.50 / 1,000,000 = $0.00035
• المجموع: $0.00125 لكل دور

عند هذا الحجم، تكلف 100 دور $0.125. يوم عمل طويل من 400 دور يكلف $0.50. تهيمن المدخلات على الفاتورة بمجرد نمو المحادثات، لأن Cursor يعيد إرسال السجل. بدء دردشة جديدة عند تغيير المهام هو أسهل طريقة للحفاظ على هذا الرقم منخفضًا.

عندما تريد أكثر من التجربة، الشحنات هي أي مبلغ صحيح من $20 إلى $500، مع مكافأة +5% من $50، و+10% من $100 و+15% من $200. يمكنك الدفع بالبطاقة (Visa، Mastercard، Apple Pay، Google Pay) أو بالعملات المشفرة (USDT على TRC20، USDC على Base). التفاصيل موجودة في صفحة الأسعار.

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

401 أو مفتاح غير صالح

تم لصق المفتاح مع مسافة لاحقة، أو ينتمي إلى موقع مختلف. أعد تشغيل اختبار curl بنفس السلسلة. إذا نجح curl ولم ينجح Cursor، الصق المفتاح مرة أخرى.

404 أو النموذج غير موجود

عادةً ما يكون عنوان URL الأساسي مفقودًا منه /v1 أو يحتوي على مسار إضافي في النهاية. يجب أن يكون اسم النموذج بالضبط uncensored.

استجابات 429

المفتاح الكامل يسمح بـ 8 طلبات متزامنة و 300 طلب في الدقيقة. المفتاح التجريبي يسمح بـ 2 طلب متزامن و 60 في الدقيقة. رمز الخطأ rate_limited يعني الكثير من الطلبات في الدقيقة و concurrency يعني الكثير في وقت واحد. في حالة الحمل الزائد المؤقت، تحصل أيضًا على 429 مع Retry-After: 5. الاستجابة المتدفقة تحتفظ بخانتها حتى ينتهي البث، لذا فإن نوافذ محرر متعددة تبث في نفس الوقت يمكن أن تصل إلى حد التزامن على مفتاح تجريبي.

النموذج يرفض أو يبتعد عن الموضوع

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

تدرج مستندات البدء السريع رؤوس الإرجاع في كل استجابة، بما في ذلك X-Request-Id، وهو مفيد للاقتباس عند التواصل مع الدعم.

المزيد من الأدلة

• كيفية استخدام DeepSeek API في SillyTavern: نقطة نهاية مخصصة
• مثال Python لـ DeepSeek API: الدردشة، البث المتدفق، الأدوات
• مفتاح DeepSeek API: الوصول إلى LLM بدون رقابة