API الخاص بـ DeepSeek V4: أول طلب في خمس دقائق

المصادقة وURL الأساسي

تستخدم واجهة برمجة التطبيقات الخاصة بنا مصادقة مفتاح API القياسية. يمكنك إنشاء مفتاح فورًا من صفحة Get API key بإدخال بريدك الإلكتروني وكلمة المرور. لا يتطلب الأمر بطاقة ائتمان للتجربة، والتي تتضمن رصيدًا صالحًا بقيمة $0.50 لمدة 7 أيام. بمجرد حصولك على المفتاح، قم بتكوين عميلك لاستخدام URL الأساسي الخاص بنا: https://api.deepseek4api.com/v1.

عيّن رأس Authorization إلى Bearer YOUR_API_KEY. يعمل هذا URL الأساسي مع أي حزمة SDK متوافقة مع OpenAI. معرف النموذج الذي يجب عليك تحديده في طلباتك هو uncensored. يضمن ذلك تفاعلك مع نموذجنا مفتوح الأوزان الذي تم ضبطه لاستجابات غير مقيدة، بدلاً من أي إصدار خاص بالبائع.

يتيح لك هذا الإعداد دمج قدرات LLM بدون رقابة في مشاريع JavaScript أو TypeScript. تتعامل SDK مع تسلسل JSON وطلبات HTTP تلقائياً. يمكنك توسيع هذا الإعداد الأساسي ليشمل الأدوات أو استدعاء الدوال إذا كانت تطبيقك يتطلب مخرجات بيانات مهيكلة.

أرسل طلب إكمال محادثة قياسي لتوليد النص. تقبل واجهة برمجة التطبيقات قائمة من الرسائل تحتوي على حقول role و content. فيما يلي مثال cURL أساسي يوضح استعلام نصي بسيط. يعمل هذا مع أي عميل متوافق مع OpenAI عن طريق تعديل URL الأساسي ومعرف النموذج.

Copycurl https://api.deepseek4api.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

استبدل YOUR_API_KEY بالمفتاح الذي قمت بإنشائه. سيحتوي الاستجابة على مصفوفة choices قياسية تحتوي على النص المُولّد. لاحظ أن نقطة النهاية هذه تدعم استدعاء الأداة/الدالة، مما يتيح لك دمج المخرجات المهيكلة في تطبيقاتك.

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

استخدم حزمة Python SDK الرسمية من OpenAI للتفاعل مع واجهة برمجة التطبيقات الخاصة بنا. قم بتكوين العميل باستخدام URL الأساسي الخاص بنا ومفتاح API الخاص بك. اسم النموذج هو uncensored. يتيح لك هذا النهج الاحتفاظ بكود العميل الحالي مع تبديل نموذج الخلفية.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseek4api.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

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

استخدام حزمة Node SDK

لتطبيقات Node.js، استخدم حزمة npm openai. قم بتهيئة العميل مع baseURL الذي يشير إلى خدمتنا وقم بتوفير مفتاح API الخاص بك. يظل معرف النموذج هو uncensored.

Copyimport OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

يتيح لك هذا الإعداد دمج قدرات LLM بدون رقابة في مشاريع JavaScript أو TypeScript. تتولى حزمة SDK التعامل مع تسلسل JSON والطلبات HTTP تلقائياً. يمكنك توسيع هذا الإعداد الأساسي لتشمل الأدوات أو استدعاء الدوال إذا كانت تطبيقاتك تتطلب مخرجات بيانات مهيكلة.

الاستجابات المتدفقة

لتوليد النص في الوقت الفعلي، فعّل البث المتدفق في عميلك. عيّن stream: true في معاملات طلبك. تُرجع واجهة برمجة التطبيقات أحداث SSE (Server-Sent Events)، مما يتيح لك معالجة الرموز (tokens) أثناء توليدها. يقلل هذا من زمن الاستجابة المدرك للمستخدمين النهائيين.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

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

حدود المعدل، الأخطاء، والسياق

تفرض واجهة برمجة التطبيقات نافذة سياق 100,000 رمز لكل من الموجّه والإكمال معًا. يجب ألا تتجاوز أحمال الطلبات 8 MB. أنت مقيد بـ 300 طلب في الدقيقة لكل مفتاح API. إذا تجاوزت هذا الحد، ستتلقى خطأ حد المعدل 429.

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