getdeepseekapi.comالدليل
عنوان URL الخاص بواجهة برمجة تطبيقات DeepSeek وعنوان URL الأساسي: كيفية التبديل
عنوان URL الخاص بواجهة برمجة تطبيقات deepseek الذي تنسخه من وثائق DeepSeek الخاصة هو عنوان URL أساسي، ويعمل فقط مع مفتاح DeepSeek ونماذج DeepSeek. إذا كنت تريد نقطة نهاية على طراز OpenAI مختلفة، فقم بتغيير عنوان URL هذا والمفتاح ومعرف النموذج.
تم التحديث
نقاط رئيسية
- عنوان URL الأساسي هو بادئة؛ تضيف مجموعة أدوات التطوير (SDK) /chat/completions إليه.
- تستخدم هذه الخدمة https://api.getdeepseekapi.com/v1 بمعرف النموذج uncensored.
- إنها ليست API الخاصة بـ DeepSeek، لذا لن يعمل مفتاح DeepSeek هنا والعكس صحيح.
- تقبل معظم البرامج أيضًا عنوان URL والمفتاح من خلال OPENAI_BASE_URL وOPENAI_API_KEY.

عنوان URL الأساسي، نقطة النهاية، والمسار: الأجزاء الثلاثة
غالباً ما يلصق المستخدمون عنواناً كاملاً في حقل يتوقع بادئة، ثم يحصلون على خطأ 404. ثلاثة مصطلحات تبين هذا التمييز.
- عنوان URL الأساسي: البادئة المشتركة لكل استدعاء، على سبيل المثال
https://api.getdeepseekapi.com/v1. هذا هو ما تضعه في إعداد "API base" أو "Base URL" في العميل. - مسار نقطة النهاية: الجزء الذي تضيفه أدوات SDK، مثل
/chat/completions،/responsesأو/models. - عنوان URL الكامل: العنوان الأساسي مضافاً إليه المسار، مثل
https://api.getdeepseekapi.com/v1/chat/completions. عملاء HTTP الخام مثل curl يحتاجون هذا العنوان.
القاعدة التي تلتقط معظم الأخطاء: أدوات SDK والتطبيقات تطلب عنوان URL الأساسي، بينما تطلب أدوات curl وعقد HTTP عنوان URL الكامل. إذا أعطتك الأداة خطأ 404، تحقق أولاً مما إذا كنت قد وضعت عنوان URL كاملاً حيث كان مطلوباً عنوان أساسي، أو العكس. ظهور مسار مكرر مثل /v1/chat/completions/chat/completions في الخطأ هو الدليل الواضح.
ما هو عنوان URL الأساسي لـ DeepSeek، وما ليس كذلك
تنشر DeepSeek عنوان API الخاص بها في وثائقها، مع أسماء النماذج التي يمكن لمفتاحها استخدامها. ابحث هناك عن القيمة الحالية بدلاً من الاعتماد على مدونة، بما في ذلك هذه المدونة. يعمل مفتاح DeepSeek مع نقطة نهاية DeepSeek فقط ولا يعمل في أي مكان آخر.
الخدمة على هذا الموقع هي منتج منفصل. إنها ليست API الرسمي لـ DeepSeek، ولا تعيد التوجيه إلى DeepSeek ولا تقدم نماذج DeepSeek. إنها API متوافق مع OpenAI ومُستضاف لنموذج واحد مفتوح الأوزان، يشغله مزود مستقل ومضبط للإجابة دون رفض المحتوى للاستخدام القانوني من قبل البالغين. عنوانها هو:
https://api.getdeepseekapi.com/v1 # model: uncensored
معرف النموذج هو uncensored، والمصادقة هي Authorization: Bearer <key>. تُصدر المفاتيح في صفحة مفتاح API. إذا كنت تقارن ما يعنيه المفتاح لكل خدمة، فإن الصفحة الخاصة بـ مفتاح DeepSeek API تحتوي على مزيد من التفاصيل.
تبديل نقاط النهاية في أدوات SDK الخاصة بـ OpenAI
أي SDK متوافق مع OpenAI يعمل بمجرد تغيير عنوان URL الأساسي والمفتاح. في Python:
from openai import OpenAI
client = OpenAI(
base_url="https://api.getdeepseekapi.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Name three uses for a base URL."}],
)
print(resp.choices[0].message.content)
في Node.js، يُكتب الحقل baseURL:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.getdeepseekapi.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Name three uses for a base URL." }],
});
console.log(resp.choices[0].message.content);
لاحظ الفرق: يستخدم Python base_url، بينما يستخدم Node baseURL. يؤدي الخلط بينهما صامتاً إلى العودة إلى عنوان OpenAI الافتراضي، الذي يرفض مفتاحك بعد ذلك.
التبديل دون تعديل الكود
تقرأ أدوات SDK الرسمية لـ OpenAI متغيرين للبيئة، لذا يمكن إعادة توجيه التطبيق الحالي دون تغيير الكود:
export OPENAI_BASE_URL="https://api.getdeepseekapi.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
python app.py # the app still has to request model "uncensored"
اسم النموذج هو الجزء الذي لا يمكن تخطيه. إذا كان التطبيق يحدد اسم نموذج آخر بشكل ثابت، فسيطلب ذلك النموذج ويفشل، لذا قم بتغييره إلى uncensored في إعدادات التطبيق أو ملف التكوين. تعرض العديد من الأدوات القيم الثلاث في شاشة إعدادات واحدة، وعادةً ما تُسمى API base، وAPI key، وmodel.
يعمل نفس تبديل القيم الثلاث في أطر العمل. مع LangChain في Python، على سبيل المثال، يكفي ChatOpenAI(base_url="https://api.getdeepseekapi.com/v1", api_key="YOUR_KEY", model="uncensored"). تعمل أدوات البرمجة التي تقبل نقطة نهاية متوافقة مع OpenAI بنفس الطريقة؛ انظر الدليل في استخدام API للبرمجة.
HTTP الخام: المسارات الدقيقة
بالنسبة إلى curl والبرامج النصية وعقد HTTP التي تبنيها، فإنك تنشئ الرابط الكامل بنفسك. هذه هي المسارات في هذه الخدمة:
| الغرض | الطريقة والرابط |
|---|---|
| المحادثة | POST https://api.getdeepseekapi.com/v1/chat/completions |
| واجهة استجابة | POST https://api.getdeepseekapi.com/v1/responses |
| قائمة النماذج | GET https://api.getdeepseekapi.com/v1/models |
| الرصيد | GET https://api.getdeepseekapi.com/v1/balance |
| الرصيد، بأسلوب OpenAI | GET https://api.getdeepseekapi.com/v1/dashboard/billing/credit_grants |
curl https://api.getdeepseekapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'
استخدم HTTPS فقط. يعمل البث المتدفق عبر "stream": true باستخدام أحداث الإرسال من الخادم، والرابط نفسه يخدم كلا الوضعين.
إدخال الرابط في التطبيقات ذات شاشة الإعدادات
تحتوي العديد من واجهات المحادثة، ومحررات النصوص، وأدوات الأتمتة على خيار "نقطة نهاية متوافقة مع OpenAI". تختلف التسميات، لكن الحقول تطابق بعضها البعض:
| الحقل في التطبيق | القيمة |
|---|---|
| قاعدة API، الرابط الأساسي، نقطة النهاية، رابط الخادم | https://api.getdeepseekapi.com/v1 |
| مفتاح API، الرمز، السر | مفتاحك من هذه الخدمة |
| النموذج، اسم النموذج، معرف النموذج | uncensored |
تريد بعض التطبيقات رابط محادثة كاملًا بدلاً من الأساس. في هذه الحالة استخدم https://api.getdeepseekapi.com/v1/chat/completions. إذا كان للتطبيق زر "اختبار الاتصال"، فإنه عادةً ما يستدعي قائمة النماذج، وهي GET /v1/models. إذا فشل الزر ولكن المحادثة اليدوية تعمل، فإن فحص التطبيق أكثر صرامة من API، ويمكنك تجاهله.
اختبار سريع للتأكد من صحة الرابط فقط
قبل أن تبدأ في تصحيح أخطاء التطبيق، أثبت صحة الرابط باستخدام قائمة النماذج. لا يحتاج إلى جسم طلب ولا يكلف شيئًا:
curl -s https://api.getdeepseekapi.com/v1/models -H "Authorization: Bearer $API_KEY" # the chat model ID is uncensored
يجب أن تحصل على استجابة JSON تحتوي على مصفوفة data. يعني صفحة خطأ HTML وجود مضيف أو مسار خاطئ، مثل وجود نطاق فرعي مفقود: يبدأ المضيف بـ api.، وليس www..
تصحيح الأخطاء الشائعة
- 404 Not Found. الرابط الأساسي يفتقد
/v1، أو يحتوي عليه مرتين، أو يتضمن مسار نقطة النهاية. - 401 أو خطأ في المصادقة. استخدمت مفتاحًا من خدمة أخرى، أو أن رأس الطلب يفتقر إلى
Bearer. المفاتيح غير قابلة للتبديل بين المزوّدين. - النموذج غير موجود. الطلب لا يزال يشير إلى نموذج من المزوّد القديم. اضبط
uncensored. - لا يزال التطبيق يتصل بالخدمة القديمة. بعض الأدوات تُخزّن الإعدادات أو تقرأ متغيرًا مختلفًا. أعد تشغيل العملية وتحقق من شاشة الإعدادات.
- مشكلة في الشرطة المائلة النهائية. تتعامل معظم العملاءات مع ذلك، ولكن إذا لم يفعل أحد، احذف الشرطة المائلة النهائية من الرابط الأساسي.
إذا لم تكن متأكدًا من أي جانب يفشل، أرسل أمر curl أعلاه. رد 200 يثبت صحة عنوان URL والمفتاح والنموذج؛ أي خطأ آخر يحدث في تطبيقك. توثيق يدرج الحدود ورؤوس الطلبات مثل X-Request-Id، مما يساعد عند التواصل مع الدعم.
ما الذي يبقى كما هو بعد التبديل
تتبع أشكال الطلب والاستجابة تنسيق OpenAI، لذا تعمل مصفوفات الرسائل، وtemperature، وtop_p، وstop، وseed، والعقوبات، واستدعاء الدوال، ووضع JSON كما هو معتاد. نافذة السياق هي 100,000 رمز للموجه بالإضافة إلى الإكمال، وحجم جسم الطلب الأقصى هو 8 MB. الخدمة مخصصة للنصوص فقط: لا صور، ولا صوت، ولا تضمينات، ولا ضبط دقيق، لذا فإن الميزات المبنية على تلك تحتاج إلى مزود مختلف.
الفوترة منفصلة أيضًا عن المزوّد القديم: $0.15 لكل مليون رمز مدخل و$0.50 لكل مليون رمز مخرج من رصيد مسبق الدفع، كما هو موضح في صفحة الأسعار. يمكن للمستخدمين الجدد الحصول على $0.50 من رصيد تجريبي مجاني للتحقق من أن التبديل يعمل قبل الدفع.
المزيد من الأدلة
أسئلة وأجوبة
ما هو عنوان URL الأساسي لـ DeepSeek API؟
ينشر DeepSeek ذلك في وثائقه الخاصة، لذا تحقق من هناك للحصول على القيمة الحالية. نقطة النهاية في هذا الموقع هي خدمة مختلفة في https://api.getdeepseekapi.com/v1.
هل يمكنني استخدام مفتاح DeepSeek على نقطة النهاية هذه؟
لا. تُصدر المفاتيح لكل خدمة. احصل على مفتاح لـ API هذا من صفحة المفاتيح، واضبط النموذج على uncensored.
هل يجب أن ينتهي عنوان URL الأساسي بـ /v1؟
نعم لهذه الخدمة: https://api.getdeepseekapi.com/v1. تضيف المكتبات مسار نقطة النهاية بعد ذلك، لذا لا تضف /chat/completions بنفسك.
لماذا أحصل على 404 بعد تغيير عنوان URL؟
عادةً ما يكون المسار مكررًا أو مفقودًا /v1. قارن عنوان URL الأساسي الخاص بك مع القيمة الدقيقة المذكورة أعلاه.
مفتاحك على بُعد استمارة واحدة
أنشئ حساباً، وانسخ المفتاح، ثم غيّر الرابط الأساسي. هذا هو الإعداد الكامل.