deepseek4api.comالدليل
ذكاء اصطناعي بدون رقابة في VS Code: Continue و Cline و Cursor
يتلخص إعداد API الخاص بـ deepseek v4 في VS Code ثلاث قيم: Base URL، ومفتاح API، ومعرف النموذج. يوضح هذا الدليل بالضبط أين تلصقها في Continue وCline وCursor، وكيفية اختبار الاتصال أولاً، وماذا تفعل عند الفشل.

نقاط رئيسية
- يعمل أي امتداد محرر مع مزود متوافق مع OpenAI: استخدم عنوان URL الأساسي https://api.deepseek4api.com/v1 ومعرف النموذج
uncensored. - اختبر باستخدام curl على GET /v1/models قبل لمس المحرر، حتى تتأكد من صحة المفتاح وعنوان URL.
- يدعم الـ API إكمال الدردشة فقط، لذا استخدمه للدردشة والتعديلات والوكلاء، وليس للإكمال التلقائي بزر Tab داخل السطر.
- يكلف سؤال برمجي نموذجي يحتوي على 8,000 رمز من السياق حوالي $0.0017.
ما تحتاجه قبل البدء
المحررات التي تتيح لك استخدام نموذجك الخاص تطلب جميعها نفس المتطلبات الثلاثة. إليك هذه المتطلبات لهذه الخدمة.
| الإعداد | القيمة |
|---|---|
| عنوان URL الأساسي | https://api.deepseek4api.com/v1 |
| مفتاح API | المفتاح الخاص بك من صفحة مفتاح API، يُرسل كـ Authorization: Bearer |
| معرّف النموذج | uncensored |
| نوع المزود | «OpenAI» أو «متوافق مع OpenAI» |
توضيح سريع حتى لا تفاجئك التفاصيل لاحقاً. اسم هذا الموقع يشير إلى DeepSeek V4، لكن النموذج خلف نقطة النهاية هو نموذج مفتوح الأوزان يديره مزود مستقل. إنه ليس API الرسمي الخاص بـ DeepSeek. في المحرر، اختر المزود العام المتوافق مع OpenAI، وليس المزود الخاص بعلامة تجارية واحدة، لأن المزود الخاص يشير إلى خوادم تلك العلامة التجارية ويتجاهل Base URL الخاص بك.
يمكن للمستخدمين الجدد الحصول على رصيد تجريبي بقيمة $0.50 بنقرة واحدة بعد التسجيل، دون الحاجة إلى بطاقة، وهو مبلغ كافٍ للاختبارات أدناه. يعمل مفتاح التجربة بحدّ 2 طلب متزامن و60 طلباً في الدقيقة.
اختبر نقطة النهاية من طرفية الأوامر أولاً
نصف مشاكل إعداد المحررات تتعلق بخطأ في الـ URL أو مفتاح مُدخل بشكل خاطئ، والمحررات ضعيفة في إخبارك بالخطأ. أمران curl يزيلان التخمين. افتح الطرفية داخل VS Code (Ctrl+` على Windows وLinux، Cmd+` على macOS) وشغّل الأمر الأول.
# expect the model id "uncensored" in the list
curl https://api.deepseek4api.com/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"
يجب أن ترى قائمة JSON تتضمن النموذج uncensored. الآن أرسل طلب دردشة حقيقي:
curl https://api.deepseek4api.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 linked list."}],
"max_tokens": 300
}'
إذا نجح الاثنان، سيعمل المحرر بنفس القيم. إذا أرجع الأمر الأول خطأ تفويض، فالمفتاح خاطئ أو يحتوي على فراغ زائد. إذا حصلت على خطأ 404، تحقق من أن الـ URL ينتهي بـ /v1 ولا يحتوي على مسار إضافي بعده.
Continue في VS Code
Continue هو ملحق مساعد مفتوح المصدر لـ VS Code وJetBrains. ثبّته من لوحة الإضافات، افتح لوحته، وافتح ملف الإعداد من أيقونة الترس. في الإصدارات الحالية، الملف هو config.yaml، ويبدو إدخال النموذج لهذا API كالتالي:
models:
- name: Uncensored API
provider: openai
model: uncensored
apiBase: https://api.deepseek4api.com/v1
apiKey: YOUR_API_KEY
roles:
- chat
- edit
- apply
defaultCompletionOptions:
contextLength: 100000
maxTokens: 2000
temperature: 0.4
تستخدم إصدارات Continue الأقدم ملف config.json يحتوي على مصفوفة models بدلاً من ذلك، حيث تظهر الحقول نفسها بصيغة "provider": "openai"، "model": "uncensored" و "apiBase": "https://api.deepseek4api.com/v1". تغير تنسيق الملف بين الإصدارات، لذا إذا أظهرت لك اللوحة تخطيطاً مختلفاً، اتبع الهيكل الذي أنشأه لك Continue واستبدل القيم بهذه القيم الثلاث.
طول السياق 100000 يتوافق مع نافذة هذا الـ API (الموجّه زائد الإكمال). قيمة maxTokens الأقل هي سقف لكل رد. يحميك من إجابة طويلة لم تكن بحاجة إليها. احفظ الملف، اختر النموذج من القائمة المنسدلة للدردشة في Continue، واسأل سؤالاً حول الملف المفتوح. حدد الكود واستخدم أمر التعديل لإعادة كتابة التحديد.
Cline
Cline هو ملحق بأسلوب الوكيل يقرأ الملفات، يقترح التعديلات ويشغل الأوامر بموافقتك. افتح إعداداته، اختر مزود الـ API المسمى "OpenAI Compatible"، واملأ الحقول:
- عنوان URL الأساسي:
https://api.deepseek4api.com/v1 - مفتاح API: مفتاحك
- معرف النموذج:
uncensored
الوكلاء ثرثارون. قد تؤدي مهمة واحدة إلى إطلاق عشرات الطلبات بينما تقرأ الأداة الملفات وتعدلها وتتحقق من النتائج، ويعيد كل طلب إرسال المحادثة حتى تلك اللحظة. هنا يهم حساب التكلفة. لنفترض أن خطوة الوكيل تحمل 40,000 رمز من السياق وتكتب 1,500 رمز. تبلغ تكلفة ذلك 40,000 × $0.15 / 1M زائد 1,500 × $0.50 / 1M، وهو $0.006 زائد $0.00075، أو $0.00675. عشرون خطوة من هذا النوع لمهمة واحدة تصل إلى $0.135. ابدأ مهاماً جديدة بدلاً من السماح لمحادثة واحدة بالنمو لساعات، وستبقى فاتورتك ثابتة.
يدعم الـ API استدعاء الأدوات (tools، tool_choice و tool_calls المتدفق، مع إرجاع النتائج بصيغة role: "tool")، وهو ما تعتمد عليه امتدادات الوكلاء. تحقق من التوثيق للحصول على شكل الطلب الدقيق إذا كنت تبني وكيلك الخاص.
Cursor والمحررات الأخرى
Cursor محرر منفصل مبني على شفرة VS Code. يحتوي على صفحة إعدادات النموذج حيث يمكنك إدخال مفتاح OpenAI الخاص بك وتجاوز الـ Base URL الخاص بـ OpenAI. الصق https://api.deepseek4api.com/v1 هناك، الصق مفتاحك، وأضف نموذجاً مخصصاً باسم uncensored. خيارات Cursor وقواعد الخطط تتغير من وقت لآخر، لذا تحقق من توثيقه الحالي لمعرفة مكان التجاوز وأي الميزات تستخدمه. الميزات التي تعمل على نماذج Cursor الخاصة به، مثل إكمال العلامات التبعية، لا تمر عبر نقطة النهاية الخاصة بك.
نفس النهج يعمل في أي أداة تقدم مزودًا متوافقًا مع OpenAI: Zed، وإضافات JetBrains، وإضافات Neovim، ومساعدي الطرفية والبرامج النصية الخاصة بك. إذا كانت الأداة تقبل فقط قائمة ثابتة للموردين، ابحث عن متغير بيئة. العديد من الأدوات المستندة إلى OpenAI تقرأ OPENAI_BASE_URL وOPENAI_API_KEY، والتي يمكنك تعيينها في الطرفية:
# base URL https://api.deepseek4api.com/v1, model uncensored
export OPENAI_BASE_URL="https://api.deepseek4api.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"
# then select the model name "uncensored" inside the tool
ما يعمل بشكل جيد وما لا يعمل
كن واضحًا بشأن التوافق بين هذا الـ API وعمليات تطوير البرمجيات.
- يعمل: مناقشة الكود الخاص بك، شرح الأخطاء، كتابة الدوال، إعادة هيكلة جزء من الكود، توليد اختبارات، صياغة رسائل الالتزام (commit messages)، وأدوات الوكلاء التي تستدعي الدوال.
- لا يعمل: إكمال تلقائي مضمن يعتمد على نقاط نهاية الإكمال في الوسط. تعرض الواجهة البرمجية
POST /v1/chat/completionsوGET /v1/modelsفقط، لذا لا توجد طريقة إكمال قديمة. احتفظ بأداة أخرى للإكمال بزر Tab إذا كنت تعتمد عليها. - غير متوفر: التضمينات، لذا فإن الإضافات التي تقوم بفهرسة قاعدة الشفرة البرمجية الخاصة بك باستخدام نموذج تضمين تحتاج إلى مصدر تضمين منفصل. ينطبق الأمر نفسه على توليد الصور والصوت والفيديو، والضبط الدقيق.
النموذج هو نموذج نصي عام لا يرفض الاستخدام القانوني للبالغين. لا نقدم ادعاءات بشأن اختبارات الأداء المرجعية في البرمجة، لذا قيّمه على كودك الخاص. استخدم درجة حرارة منخفضة للكود، حوالي 0.2 إلى 0.4، وامنح الملحق تعليمات واضحة حول اللغة والأسلوب.
من حيث التكلفة، سؤال برمجة يرسل 8,000 رمز من سياق الملف ويحصل على إجابة مكونة من 1,000 رمز يكلف 8,000 × $0.15 / 1M زائد 1,000 × $0.50 / 1M، وهو $0.0012 زائد $0.0005، أو $0.0017. مائة من تلك في يوم عمل واحد على مدار 22 يوماً هي 2,200 طلب و$3.74. انظر صفحة الأسعار لشرائح الشحن.
استكشاف الأخطاء الشائعة وإصلاحها
| العَرَض | السبب المحتمل | الحل |
|---|---|---|
| خطأ 401 أو خطأ في التفويض | مفتاح خاطئ، فراغ إضافي، أو لصق المفتاح في الحقل الخطأ | انسخ المفتاح مرة أخرى، ثم كرر اختبار curl |
| خطأ 404 غير موجود | عنوان URL الأساسي يفتقد /v1 أو يحتوي على مسار زائد | استخدم بالضبط https://api.deepseek4api.com/v1 |
| النموذج غير موجود | تمت كتابة اسم النموذج بشكل مختلف | استخدم uncensored بحروف صغيرة |
429 مع concurrency | طلبات أكثر في وقت واحد مما يسمح به مفتاحك (8 للمفتاح العادي، 2 للتجريبي) | قلل الطلبات المتزامنة للإضافة، أو انتظر |
429 مع rate_limited | أكثر من 300 طلب في الدقيقة (60 للمفتاح التجريبي) | أبطئ الوكيل أو خطوات الدفعات |
429 مع Retry-After: 5 | حمل زائد مؤقت | أعد المحاولة بعد خمس ثوانٍ |
| الطلب كبير جدًا | Body أكبر من 8 MB | أرسل ملفات أقل أو أصغر كسياق |
تحتفظ الاستجابات المتدفقة بخانة طلب متزامن حتى ينتهي البث، لذا إذا فتحت عدة لوحات دردشة في وقت واحد بمفتاح تجريبي، ستصل إلى حد الطلبات المتزامنة أسرع مما تتوقع. تحقق من رؤوس الاستجابة X-RateLimit-Limit-Requests وX-RateLimit-Limit-Concurrency لتأكيد ما يسمح به مفتاحك، والرأس X-Balance-USD لمعرفة مقدار الرصيد المتبقي. الطلبات الفاشلة لا تُحسب، لذا فإن إعادة المحاولة مجانية.
المزيد من الأدلة
أسئلة وأجوبة
ما هو معرف النموذج الذي أدخله في VS Code؟
أدخل uncensored بحروف صغيرة، مع عنوان URL الأساسي https://api.deepseek4api.com/v1 ومفتاح API الخاص بك. اختر نوع المزود المتوافق مع OpenAI في الامتداد.
هل هذا هو الـ API الرسمي لـ DeepSeek V4؟
لا. إنه نموذج مفتوح الأوزان واحد تشغله جهة مستقلة، وهو ليس واجهة برمجة التطبيقات الرسمية من DeepSeek أو أي مزوّد آخر.
هل يمكنني استخدامه للإكمال التلقائي المضمن للكود؟
ليس لإكمال النص في المنتصف. توفر واجهة برمجة التطبيقات إكمال المحادثات وقائمة النماذج فقط. يعمل للمحادثات والتعديلات وأدوات الوكلاء.
لماذا أحصل على أخطاء 429 في امتداد الوكيل؟
الوكلاء يرسلون العديد من الطلبات في وقت واحد. المفتاح الكامل يسمح بـ 8 طلبات متزامنة و300 في الدقيقة، والمفتاح التجريبي يسمح بـ 2 و60. قلل من التوازي أو أعد المحاولة بعد تأخير Retry-After.
مفتاحك على بُعد نموذج تسجيل واحد
أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذا هو الإعداد كله.