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

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

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

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

إرسال إكمال الدردشة

أرسل طلب POST قياسي إلى /v1/chat/completions لتلقي استجابة نصية. تقبل نقطة النهاية مصفوفة messages التي تحتوي على الموجّه النظامي واستعلام المستخدم، بالإضافة إلى مُعرّف model مضبوطًا على uncensored. يعمل هذا النموذج على خوادم GPU الخاصة بنا وهو مُعدّ للإجابة دون رفض المحتوى للاستخدام القانوني للبالغين.

تأكد من أن جسم الطلب لا يتجاوز 8 ميجابايت. إذا كان المفتاح غير صالح أو منتهي الصلاحية، سيرجع الخادم خطأ 401. إذا استنفدت رصيدك المسبق الدفع، ستتلقى خطأ 402 يتطلب الشحن. يمكنك إضافة أموال بدءًا من $10 عبر العملات المشفرة (USDT أو USDC).

Copycurl https://api.getdeepseekapi.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."}]
  }'

تثبيت واستخدام مكتبة Python SDK

يعد استخدام مكتبة OpenAI الرسمية لـ Python أسرع طريقة للتكامل. قم بتثبيت الحزمة عبر pip، ثم قم بتكوين العميل بعنوان URL الأساسي الخاص بك ومفتاح API. يجب ضبط معلمة model على uncensored لضمان أنك تتحدث إلى مثيلنا المحدد.

يعمل هذا النهج مع أي SDK متوافق مع OpenAI، بما في ذلك تلك المستخدمة لـ Node.js أو Go. يتعامل العميل مع التسلسل وإعادة المحاولة تلقائيًا. تذكر أن مُعرّف النموذج ليس اسم مورد مثل GPT-4؛ إنه مُعرّف محدد لنموذجنا بدون رقابة.

Copyfrom 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": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

التكامل مع Node.js

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

عند بناء الطلب، حدد model: 'uncensored' في المعاملات. يضمن ذلك إرسال العميل الطلبات إلى نقطة النهاية الصحيحة للنموذج. يتعامل الـ SDK مع استجابات البث المتدفق وغير المتدفق بشكل موحد، مما يتيح لك استبدال التنفيذ دون تغيير منطق الطلب الأساسي.

Copyimport 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: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

تمكين البث (SSE)

اضبط معلمة stream على true لتلقي استجابة أحداث مرسلة من الخادم (SSE). يرسل الخادم سلسلة من القطع، يحتوي كل منها على جزء من النص المولد. يقلل هذا من زمن الاستجابة المدرك للاستجابات الطويلة ويتيح للعميل عرض الرموز بمجرد إنتاجها.

تأكد من أن كود العميل الخاص بك يتعامل بشكل صحيح مع حدث إنهاء البث. لا يغير البث المتدفق التسعير أو حساب الرموز؛ لا يزال يتم شحن الرصيد لكل مليون رمز للإدخال والإخراج. تظل نافذة السياق الإجمالية محدودة بـ 100,000 رمز للموجّه والإكمال معًا.

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)

الحدود والأخطاء ونافذة السياق

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

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