مفتاح DeepSeek API في VS Code: الإعداد باستخدام API الخاص بنا

النسخة المختصرة

سألتَ عن كيفية استخدام مفتاح deepseek api key في vscode، والإجابة تتكون من جزأين. أولاً، لا يقبل VS Code نفسه مفتاح API لنموذج لغوي؛ بل يقوم بذلك ملحق. ثانياً، المفتاح من هذا الموقع ليس مفتاح DeepSeek. إنه ينتمي إلى واجهة برمجة تطبيقات (API) مستقلة ومتوافقة مع OpenAI، تشغّل نموذجاً مفتوح الأوزان، ومضبوطاً للإجابة دون رفض المحتوى للاستخدام القانوني للبالغين، وهو ليس الواجهة الرسمية لـ DeepSeek. إذا كانت لديك مفتاح من منصة DeepSeek الخاصة، فأدخله باستخدام نقطة النهاية الخاصة بـ DeepSeek.

بالنسبة لهذه الواجهة، يحتاج كل ملحق إلى نفس القيم الثلاث:

• عنوان URL الأساسي: https://api.deepseekapikey.com/v1
• مفتاح API: المفتاح من حسابك، يُرسل كرمز Bearer
• النموذج: uncensored

توضح الأقسام أدناه أين توضع هذه القيم في Continue وفي ملحقات عائلة Cline، ثم كيفية التحقق من أن كل شيء يعمل والحفاظ على التكاليف قابلة للتنبؤ.

قبل البدء: احصل على مفتاح واجربه

سجّل في صفحة مفتاح API باستخدام Google أو عبر البريد الإلكتروني وكلمة المرور. يمكن للمستخدمين الجدد المطالبة برصيد تجريبي مجاني بقيمة $0.50 بنقرة واحدة، صالح لمدة 7 أيام، شخص واحد، بدون بطاقة. تبدأ الشحنات المدفوعة بمبلغ $20.

افتح الطرفية المدمجة في VS Code (Ctrl+` أو Cmd+`) وقم بإرسال طلب. إذا نجح هذا، فإن أي فشل لاحق يكون ناتجاً عن إعداد الملحق وليس عن مشكلة في المفتاح.

Copyexport API_KEY="paste-your-key-here"

curl https://api.deepseekapikey.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 string."}],
    "max_tokens": 200
  }'

تعني الاستجابة بصيغة JSON التي تحتوي على مصفوفة choices أن المفتاح وعنوان URL واسم النموذج صحيحان. تعني الاستجابة 401 أن المفتاح غير صحيح. تعني الاستجابة 404 عادةً أن المسار خاطئ. يمكنك أيضاً إجراء طلب GET /v1/models بنفس الرأس كاختبار رخيص.

الخيار 1: ملحق Continue

يعد Continue ملحقاً للمساعد مفتوح المصدر لـ VS Code يتيح لك تعريف نماذجك الخاصة. قم بتثبيته من لوحة الإضافات، وافتح إعداداته، وأضف نموذجاً يستخدم مزود OpenAI مع عنوان API أساسي مخصص. لقد غيّر Continue تنسيق التكوين الخاص به بمرور الوقت، من ملف JSON إلى ملف YAML، لذا تحقق من وثائق الملحق الحالية إذا بدا ملفك مختلفاً. تحمل الحقول نفس المعنى في كلا التنسيقين. في شكل JSON، تبدو إدخال النموذج كالتالي:

Copy{
  "models": [
    {
      "title": "Uncensored API",
      "provider": "openai",
      "model": "uncensored",
      "apiBase": "https://api.deepseekapikey.com/v1",
      "apiKey": "YOUR_KEY"
    }
  ]
}

في شكل YAML، يحمل إدخال النموذج نفس المفاتيح: اسم، provider: openai، model: uncensored، apiBase مضبوطاً على عنوان URL الأساسي، والمفتاح. احفظ الملف، واختر النموذج الجديد من القائمة المنسدلة للنماذج في Continue، واسأل سؤالاً في اللوحة الجانبية.

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

المفتاح موجود في ملف، لذا احتفظ بهذا الملف خارج مستودعك. إذا كنت تستخدم تكويناً على مستوى مساحة العمل، فأضفه إلى .gitignore، أو استخدم التكوين العالمي في دليل المنزل.

الخيار 2: Cline وملحقات الوكلاء المشابهة

Cline، والتوسعات المشتقة منه مثل Roo Code، تشغّل وكيلًا يقرأ الملفات، ويقترح التعديلات، ويشغّل الأوامر بموافقتك. يحتوي لوحة الإعدادات الخاصة به على قائمة منسدلة لمزود API. اختر الإدخال الخاص بمزود متوافق مع OpenAI واملأ النموذج:

1. عنوان URL الأساسي: https://api.deepseekapikey.com/v1
2. مفتاح API: مفتاحك
3. معرف النموذج: uncensored

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

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

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

استدعاء واجهة برمجة التطبيقات من الكود الخاص بك في VS Code

أحياناً يكون الهدف ليس إضافة امتداد بل سكريبت تشغله من محرر النصوص. تعمل أي مكتبة OpenAI SDK. في Node.js:

Copyimport OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.deepseekapikey.com/v1",
  apiKey: process.env.API_KEY,
});

const res = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Review this function for off-by-one errors." }],
});
console.log(res.choices[0].message.content);

احتفظ بالمفتاح في متغير بيئة، أو ملف .env يتم تجاهله في git، أو مخزن الأسرار في نظام التشغيل الخاص بك، وليس في ملف مُلتزم بالتتبع. تستخدم النسخة من Python نفس الاستدعاء بصيغة OpenAI(base_url="https://api.deepseekapikey.com/v1", api_key=...). يحتوي البدء السريع على المزيد من الأمثلة، بما في ذلك البث المتدفق ووضع JSON.

تكلفة جلسات البرمجة

السعر هو $0.15 لكل مليون رمز مدخل و$0.50 لكل مليون رمز مخرج. يرسل مساعدو البرمجة الكثير من السياق، لذا يهيمن المدخل. خذ طلباً يحتوي على 30,000 رمز من الكود وسجل الدردشة وإجابة مكونة من 1,000 رمز:

• مدخل: 30,000 / 1,000,000 × $0.15 = $0.0045
• مخرج: 1,000 / 1,000,000 × $0.50 = $0.0005
• المجموع: $0.005 لكل طلب، لذا فإن 200 طلب تكلف $1.00.

موجّه كامل مكون من 100,000 رمز مع نفس الإجابة يكلف $0.015 + $0.0005 = $0.0155. لا يزال هذا مبلغاً صغيراً، لكن حلقات الوكلاء تكرر ذلك مرات عديدة، لذا حافظ على السياق ضيقاً: افتح الملفات ذات الصلة فقط، وليس المستودع بأكمله، وابدأ دردشة جديدة عندما تتغير المهمة.

الرصيد مسبق الدفع ولا ينتهي، ولا يوجد اشتراك. الطلبات الفاشلة أو المرفوضة لا تُحسب. قم بشحن الرصيد بمبلغ صحيح يتراوح بين $20 و$500، مع زيادة 5% من $50، و10% من $100، و15% من $200، بالدفع بالعملات المشفرة فقط (USDT على TRC20، USDC على Base). يضيف شحن بقيمة $50 رصيداً بقيمة $52.50. راجع صفحة الأسعار للحصول على التفاصيل.

قائمة استكشاف الأخطاء

• 401 غير مصرح. المفتاح غير صحيح أو يحتوي على مسافات بيضاء لاحقة. تذكر أن المفتاح الصادر عن منصة DeepSeek الخاصة لن يعمل هنا.
• 404 غير موجود. تحقق من عنوان URL الأساسي. تضيف بعض الإضافات /chat/completions تلقائياً، لذا زودها بعنوان URL أساسي ينتهي بـ /v1. أخرى تريد المسار الكامل. اتبع التلميح في الحقل.
• النموذج غير موجود. يجب أن يكون معرف النموذج بالضبط uncensored.
• 429 مع الرمز concurrency. طلبات كثيرة في وقت واحد. أغلق الدردشات أو الوكلاء الإضافيين. تحمل الطلبات المتدفقة مكانها حتى تنتهي.
• 429 مع Retry-After: 5. حمل زائد مؤقت. انتظر خمس ثوانٍ وعادةً ما ينجح إعادة المحاولة في الإضافة.
• الطلب كبير جداً. حد حجم جسم الطلب هو 8 MB، وحد السياق هو 100,000 رمز. قلل الملفات المرفقة.

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

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

• مفتاح DeepSeek API في Janitor AI: الإعداد باستخدام واجهة برمجة التطبيقات الخاصة بنا
• مفتاح DeepSeek API في SillyTavern: ربط الـ API الخاص بنا
• DeepSeek API: خرافات مقابل حقائق للوصول بدون رقابة