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

إعداد المصادقة

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

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

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

يتبع الـ API الخاص بنا تنسيق OpenAI لإكمال الدردشة. وجه عميلك إلى عنوان URL الأساسي الخاص بنا وأرسل طلب POST مع رسائلك. معرف النموذج المراد استخدامه هو "uncensored". هذا النموذج مفتوح الأوزان مضبوط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين.

يوضح المثال أدناه بنية cURL الأساسية. استبدل YOUR_API_KEY بمفتاحك الفعلي.

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

تذكر أن الأخطاء والرفضات مجانية. تدفع فقط مقابل الرموز التي تمت معالجتها بنجاح. عنوان URL الأساسي هو https://api.deepseekcoder.top/v1.

تكامل SDK لـ Python

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

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

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseekcoder.top/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. يمكنك تبديل عنوان URL الأساسي لاختبار مزودي مختلفين أو الالتزام بنقطة النهاية الخاصة بنا بدون رقابة لمهام الترميز.

استخدام SDK لـ Node.js

لمطوري JavaScript، يعمل SDK لـ Node.js بشكل متطابق. قم بتكوين خصائص apiKey و baseURL في مثيل العميل. يضمن ذلك توجيه جميع المكالمات اللاحقة إلى خوادمنا.

يوضح المثال أدناه كيفية إجراء طلب. يحتوي الرد على النص المُولّد وإحصائيات استخدام الرموز. يمكنك دمج هذا مباشرة في خطوط أنابيب البناء أو نصوص التطوير المحلية.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.deepseekcoder.top/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);

لا توجد مكتبات إضافية مطلوبة بخلاف حزمة OpenAI القياسية. تدعم نقطة النهاية طرق HTTP والعناوين المتوقعة من العملاء المتوافقين مع OpenAI.

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

للحصول على مساعدة ترميز في الوقت الفعلي، فعّل البث المتدفق عن طريق تعيين stream: true. تُعيد الـ API أحداث SSE. يحتوي كل جزء على نص جزئي، ويشمل الجزء الأخير إجمالي استخدام الرموز.

يقلل البث المتدفق من زمن الاستجابة المدرك للمطورين الذين ينتظرون توليد الكود. يوفر الجزء الأخير عدد الرموز القابلة للفوترة. يتيح ذلك لتطبيقك تحديث واجهة المستخدم تدريجياً.

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 طلب في الدقيقة لكل مفتاح، مع حد للتزامن يبلغ 8 طلبات متزامنة. يجب ألا يتجاوز حجم طلب الجسم 8 MB.

تشمل الأخطاء الشائعة 401 (مفتاح غير صالح)، و402 (رصيد غير كافٍ)، و429 (حدّ المعدل). يغطي رصيدك المسبق الدفع استخدام الرموز؛ ولا تستهلك الأخطاء الرصيد. نافذة السياق هي 100,000 رمز إجمالاً (الموجّه + الإكمال). الحد الأقصى للإخراج هو 32,000 رمز لكل طلب، أو 2,048 إذا لم يتم تعيين max_tokens. الرصيد لا ينتهي، ولا توجد رسوم شهرية.